Difference between revisions of "Homebrew Browser"

From WiiBrew
Jump to navigation Jump to search
Line 17: Line 17:
 
No more dead links, no more extracting files, no more finding out that the homebrew  
 
No more dead links, no more extracting files, no more finding out that the homebrew  
 
application doesn't include an icon.png and meta.xml in the zip file!
 
application doesn't include an icon.png and meta.xml in the zip file!
 
[http://llref.emutalk.net/pages/projects/browser/index3.htm Online interactive demo]
 
  
 
'''Note: Not all applications/games are included yet. They will be added over time.'''
 
'''Note: Not all applications/games are included yet. They will be added over time.'''

Revision as of 06:41, 13 July 2008

Template:Infobox homebrewapp The Homebrew Browser allows you to download the latest homebrew applications and games all through your Wii. You don't need to take your SD card out. You don't even need a computer! You can also delete homebrew you no longer want.

No more dead links, no more extracting files, no more finding out that the homebrew application doesn't include an icon.png and meta.xml in the zip file!

Note: Not all applications/games are included yet. They will be added over time.

Features

  • One click download and install for each homebrew application
  • One click deletion of homebrew applications
  • One click update for homebrew apps
  • Auto updating when your Homebrew Browser version is out of date

Usage

Run the included ELF with your favourite method to boot homebrew. Uses the Wiimote with IR.

Green Tick - You have the latest version of that homebrew application installed.

Blue Tick - You don't have the latest version of that homebrew application installed.

Button Action
Wiimote A Button Click button
Wiimote - Button Previous 6 homebrew applications
Wiimote + Button Next 6 homebrew applications
Wiimote HOME Button Return to loader

If you need to correct your IR cursor in the application, use:

Button Action
Wiimote D-Pad Up Y - 25
Wiimote D-Pad Down Y + 25
Wiimote D-Pad Left X - 50
Wiimote D-Pad Right X + 50

Homebrew Apps in HBB

Date Added Application
13 July 2008 DragonMedia Player v0.1 Beta, Wii Web Server v0.76 Alpha, AtaWii v1b, FCE Ultra Wii v2008.04.27, FUSE vPreview, Genesis Plus v2008.06.1, Hugo-wii v2008.06.14, Neopop Wii v2008.06.21, ScummVM vRev 32565, SMSPlus v2008.06.01, Snes9X Wii v0.1.1, Visual Boy Advance v1.7.2, Wii64 vr300 and Yabause Wii v1Alpha
11 July 2008 DragonMedia Player v0.07 Alpha, HiivelyPlay v1.0, MPlayerWii v0.02, Wii MFE Port v1.1, OpenTyrianWii v0.9 and Wii Web Server v0.75 Alpha
10 July 2008 Wii-Tac-Toe v0.1
9 July 2008 Barrage v1.0, Box2D Balls v1.0, DrawingBox v1.0b2, ExistenzE v1.0, Jewel Quest v1.0, MiniMP3 Player v0.2, Missile Command v0.5a, MTP v2.0, PlanetHively v1.0, RayTracer v1.0, Gamecube Saver v0.1, WiiBServer v0.1, Wiihttpd v0.0.2, wiilight v1.0, WiiMotionDemo v1.5, Wii Web Server v0.74 Alpha and WiiWhiteboard v0.2b
8 July 2008 WiiPhysics v1.3
7 July 2008 SpaceShooter v0.2
6 July 2008 Chess v0.0.2 and MahJongg Wii v0.1 Beta
5 July 2008 Tanks v0.3a and ftpii v0.0.9
2 July 2008 ftpii v0.0.8, Bubble Dizzy v0.94 Beta, SD Explorer v0.9, WiiPaint v1.0, Sudoku2 v0.2b and Trojan Wii v0.1
1 July 2008 Duck Hunt v1.81
30 June 2008 WiiPhysics v1.2
29 June 2008 Touhou Fangame v0.1a, Another Rock Paper Scissors Game v0.2, Sudoku v0.1b, Snake2 v2.1 beta, Matching Cards v0.2, Bichejos v0.1, PONG v1.1, MAsteroids v0.4, CharioMan v0.1a, Scogger v0.2, Simon v0.3, WiiPoker v0.1, Ballion v1.7, Minesweeper v0.1, Asteroids v0.1, Rock Paper Scissors v1.0, Chess v0.0.1 and Tetris v1.2

How it works

  1. The Homebrew Browser (HBB) contacts the main server to receive a list of current homebrew applications. The list includes the application names, image file sizes, boot file sizes and whether it is a dol or elf file.
  2. HBB checks to see if the user has the latest image files (stored in /temp) for all homebrew listed. If the image is out of date or missing, it downloads the image file.
  3. Once in HBB and when selecting a game to install, it downloads the icon.png, meta.xml and boot.dol/elf files from the server.

Notes for Homebrew Developers

How icons for HBB are selected

If there is no icon.png file in a homebrew application then an icon is included if one can be found.

If there is no name on the icon and if the picture doesn't represent very clearly what the application does then it is replaced with an icon that has a name.

Homebrew Application folder naming

I will stick to the folder names used when you extract each homebrew application. Folders with spaces will be replaced with underscores. If your files don't come in a folder, then a folder name will be created. If your homebrew application used a folder name before HBB and you've updated your application, the user will notice that there is an update to your application.

An example is MAsteroids. The game was developed before HBB. Lets say that the game gets updated. Since they are using a folder name, I can simple place the new boot.dol/elf on the server, change the file size and when the user loads HBB it will notice that they have an existing install of MAsteroids and then the user can update to the latest version.

To make my life easier...

  • Include an icon.png and a meta.xml file with your homebrew application.
  • Try to follow the meta.xml standard and test your meta.xml file in HBC.
  • Include a date and version number with your homebrew release, otherwise I will use the timestamp from the boot.dol/elf file and name it v0.1.
  • Put your homebrew application files into a folder and then zip up that folder. Try to keep using that folder name for the homebrew applications life.

History

13 July 2008 (v0.2.0b)

  • Increased buffer size so applications that require a lot of files will work
  • Added HTTP no-cache so users behind a proxy will always retrieve the latest version of the apps list

10 July 2008 (v0.2.0a)

  • Small bugfix, downloading Raytracer, Wiiwhiteboard, etc should now work

9 July 2008 (v0.2.0)

  • Supports applications which load files from the SD card
  • Added categorisation of homebrew applications
  • Ability to install HBB via wiiload
  • Updated tick icons
  • Updated "Download" image to change to "Update" if you already have the application installed
  • New icon displays even if you have an older version of the application
  • Fixed issue when downloading 4 applications HBB would exit
  • Does not download the icon.png file if you already have that application installed

4 July 2008 (v0.1.2)

  • Added checks to make sure the server response is valid
  • Uses new graphics made by LowLines
  • New mouse pointer
  • "New" icon appears depending on the time
  • Uses GRRLIB 3.0.1a
  • (A few hours later) Fixed images getting corrupted when loaded previous and next 6 images a few times and now downloads the icon.png and meta.xml files for the HBB if you update

30 June 2008 (v0.1.1)

  • Fixed issue with requesting files from server (thanks joedj)
  • Enabled auto updating (press B when asked if you don't want to update)
  • New logo and HBC icon (thanks LowLines)

29 June 2008 (v0.1)

  • Initial Release

To do

  • Don't use a black screen when loading
  • Find calm background music
  • Print text on images at run time, instead of having images with text
  • (Distant future) Allow users to change the default icon
  • Download statistics
  • Prompt user if they want to keep their existing icon for a homebrew application they are updating
  • Replace the little about box with an about window, so things like ratings, download statistics, a longer description and maybe a screenshot can be shown

Credits

  • LowLines for the Homebrew Browser logo, HBC icon and all other graphics
  • joedj for network code in ftpii
  • NoNameNo and RedShade for GRRLIB
  • Thanks to all the Wii homebrew developers and HBC icon creators
  • Thanks to all the v0.1 testers

Homebrew Browser was written in C using devkitPPC (CVS 20080618) and libogc with libfat and GRRLIB.

A message from Low Lines

While designing graphics for teknecal's Homebrew Browser, I have been using a Flash-Based Demo to simulate it (makes it easier to design) and work on possible future features that may be added when teknecal feels ready. Discussion about this can be found here. I am open to ideas and suggestions, and this also provides everyone with a usable demonstration of the Browser.