Difference between revisions of "Homebrew Browser"

From WiiBrew
Jump to navigation Jump to search
m (onlyinclude on the list of applications, so that it can be automatically updated on the non-english wikipages of hbb.)
Line 84: Line 84:
 
==Homebrew Apps in HBB==
 
==Homebrew Apps in HBB==
 
Chronological log below. [[:Category:Homebrew in HomebrewBrowser|Alphabetical list.]] [http://www.lukegrangerbrown.uni.cc/hbb/ Visual list.]
 
Chronological log below. [[:Category:Homebrew in HomebrewBrowser|Alphabetical list.]] [http://www.lukegrangerbrown.uni.cc/hbb/ Visual list.]
 +
<onlyinclude>
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Line 680: Line 681:
 
*[[Tetris Wii|Tetris v1.2]]
 
*[[Tetris Wii|Tetris v1.2]]
 
|}
 
|}
 +
</onlyinclude>
  
 
==History==
 
==History==

Revision as of 13:42, 10 March 2009

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!

Have a useful application that isn't in HBB? Request it be added.

Check out the up to date blog with development progress at www.codemii.com. Add hbb@codemii.com to the Wii address book to get updates sent to your Wii.

Have a look at the most popular applications downloaded with the Homebrew Browser

Features

  • One click download/(un)install/update for each homebrew application
  • Auto updating when your Homebrew Browser version is out of date

How to Install

Copy the homebrew_browser folder to the /apps folder on your SD card. Ensure that the little write lock switch on your SD card is off. Launch via the Homebrew Channel.

Usage

You can view this guide which shows how to use the Homebrew Browser.

  1. If you are using the Homebrew Channel then extract the homebrew_browser directory from the archive in your apps directory in the root of your SD card.
  2. Launch Homebrew Browser from Homebrew Channel and your Wii must be connected to the Internet.
  3. Uses the Wiimote with IR to choose your favorite homebrew application.
    1. Green Tick - You have the latest version of that homebrew application installed.
    2. Yellow Tick - You don't have the latest version of that homebrew application installed.
Wiimote.svg Action
Wiimote A Button Click button
Wiimote B Button Cancel download
Wiimote D-Pad Left Wiimote D-Pad Right Previous/Next category
Wiimote - Button Wiimote + Button Previous/Next 6 homebrew applications
Wiimote HOME Button Menu

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, as well as the names of any other required files.
  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 zip file and downloads the icon.png if needed from the server. It then extracts the zip file and deletes the zip file.

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.

Homebrew Apps in HBB

Chronological log below. Alphabetical list. Visual list.

Date Added Application
7 March 2009
1 March 2009
  • MPlayer Christmas Edition v0.3
28 February 2009
22 February 2009
21 February 2009
14 February 2009
8 February 2009
1 February 2009
29 January 2009
23 January 2009
17 January 2009
  • bibleQuiz v0.9
  • Frodo v5
  • Horror Vacui v0.0.3
  • Leveltool v0.4
  • Pong2 v0.95
  • RedSquare v0.8
  • ScummVM rev35811
  • WiiLander v0.3
  • Wii Quizz v1.6.3
10 January 2009
2 January 2009
27 December 2008
20 December 2008
13 December 2008
6 December 2008
29 November 2008
23 November 2008
  • bibleQuiz v0.4
  • FCEU v2.0.6
  • Pong2 v0.92
  • REminiscence v0.83
  • Snes9xGX v007
  • Visual Boy Advance v1.0.5
  • wiilax-minitro vFinal
18 November 2008
15 November 2008
9 November 2008
1 November 2008
26 October 2008
  • FCEU v2.0.6
  • ftpii v0.0.15
  • Pong2 v0.6
18 October 2008
11 October 2008
4 October 2008
26 September 2008
21 September 2008
  • FCEU (tantric) v2.0.2
  • ftpii v0.0.14
  • GeckoOS v1.07a
  • Gnuboy GX v2008.09.17
  • Gravity v1.1
  • Map Maker v1.0
  • Pacman (emulator) v1.0
  • Visual Boy Advance v1.0.1
15 September 2008
  • Wii Breakout v0.01
  • GeckoOS v1.06f
  • FCEU (tantric) v2.0.1
  • Gravity v1.0
  • WiiDoom v0.2
  • WiiEngine v1.4
7 September 2008
3 September 2008
  • FCEU (tantric) v2008.09.01
  • GCBooter v1.0
  • GeckoOS v1.06f
  • Gnuboy GX v2008.08.26
  • MadQuiz v0.03
  • MahJongg Wii v0.4
  • Metronome v1.0
  • ScummVM v0.12
  • WiiPhysics v2.2
28 August 2008
24 August 2008
22 August 2008
17 August 2008
14 August 2008
  • DragonMedia Player v0.15 Alpha
  • Freecell v0.1
  • Guitar Fun v3.5
  • ScummVM Rev 33789
  • txt-read v1.0
10 August 2008
  • Quake v0.02
  • Uno v8
  • Wii Solitaire v0.3
07 August 2008
03 August 2008
  • DragonMedia Player v0.13 Alpha 2
  • Wii Solitaire v0.2
01 August 2008
31 July 2008
29 July 2008
  • Guitar Fun v2.9
  • Snes9xGX 1.5 (Michniewski) v003
26 July 2008
  • Asteroids v0.1 with Wiimote support
  • DragonMedia Player v0.12 Beta
  • ftpii v0.0.12
  • GeckoOS v1.06d cf
  • Genesis Plus v2008.07.16
  • Gnuboy GX v2008.07.15
  • MahJongg Wii v0.2
  • Uno v4
  • Wii Web Server v0.81 Alpha
22 July 2008
20 July 2008
19 July 2008
  • ftpii v0.0.10
  • FCEU (aksommerville) v2008.07.02
  • FCEU (Suloku) v2008.05.03
  • FCEU (Vicious1988) v2008.04.07
  • Snes9X (Falco) v2008.04.23
  • Snes9X (LoPsT) v2008.05.30
  • Snes9X (Robert) v2008.04.21
  • Snes9X (vicious1988) v2008.04.02
  • Snes9X (Yoysothoth) v2008.07.15
  • Yabause (Ac_K) v2008.06.30
17 July 2008
  • MPlayerWii v0.03
16 July 2008
15 July 2008
13 July 2008
11 July 2008
  • DragonMedia Player v0.07 Alpha
  • HiivelyPlay v1.0
  • MPlayerWii v0.02
  • Wii MFE Port v1.1
  • OpenTyrianWii v0.9
  • Wii Web Server v0.75 Alpha
10 July 2008
  • Wii-Tac-Toe v0.1
09 July 2008
08 July 2008
  • WiiPhysics v1.3
07 July 2008
  • SpaceShooter v0.2
06 July 2008
05 July 2008
02 July 2008
01 July 2008
30 June 2008
  • WiiPhysics v1.2
29 June 2008


History

24 January 2009 (v0.2.5b)

  • Keep retrying networking initialisation
  • Now shows the progress when extracting the zip files (thanks Tantric)
  • Detects the ftpii directory when using a password like ftpii_mypass
  • Keep meta.xml name when updating if it has been edited
  • Added more error checking when updating HBB, if updating fails it reverts back to the previous version
  • Media category becoming unavailable should now be fixed
  • Fixed controller screen to display accurate Dpad information

19 December 2008 (v0.2.5a)

  • Fixed XML issue which caused a code dump
  • Added update text so it now tells you what's new before you update

13 December 2008 (v0.2.5)

  • Changed blue tick to yellow tick so it can be seen easier
  • Made help and controls window larger
  • Free space is now shown at the bottom right of screen
  • Added menu when pressing home, can go into settings, reboot the wii or return to loader. Hold the home button to return to loader at any time.
  • Added settings which allow you to change when the image files are downloaded; either at startup or on-demand. Can enable or disable the free space text.
  • Added update all applications feature. You access this when clicking on the SD card icon. Once you are shown your applications, the SD card icon changes to an update icon which you can click.

9 November 2008 (v0.2.4)

  • Able to view currently installed
  • Fixed bug in downloading and removing applications which affected uno and may have affected other applications
  • Retries increased to 10 times with a longer pause in-between
  • Able to reboot the Wii by holding B and pressing Home
  • Detects if you have a .elf version of any application and lets you update that application
  • Now uses zip files which means download sizes are reduced (thanks Tantric)
  • Added SDHC support
  • Detects if HBB icon or meta file exist, if they don’t then it downloads them

26 October 2008 (v0.2.3b)

  • Using dol instead of elf to work with HBC beta 9

30 September 2008 (v0.2.3a)

  • Wlan adapter should now work with the HBB
  • Applications should now be detected properly
  • When applications are downloaded/deleted from the popular category they will now appear correctly in other categories and vice versa

29 September 2008 (v0.2.3)

  • Rebuilt with latest libfat CVS to fix delete corruption bug (thanks joedj)
  • Added Popular category
  • Updated HBB about information

6 September 2008 (v0.2.2)

  • Now downloads images in real time, no more having to wait for HBB to load
  • Fixed IR cursor, no more IR cursor correction is required (thanks Wil)
  • Deleting applications now deletes all files from the directories created (emulator roms/saves directories aren't deleted)
  • Dpad left and right now controls the categories
  • Updated HBB about image to include information about wii message notifications for HBB

3 August 2008 (v0.2.1b)

  • Added the ability to cancel downloads at any time by pressing B
  • Added a slight rumble when moving over any button
  • Moved help and controls icon to left of banner

27 July 2008 (v0.2.1a)

  • Fixed the issue when downloading most of the temporary images for the first time it caused HBB to exit
  • Added text to describe what each icon does when you move the cursor over it

26 July 2008 (v0.2.1)

  • Cursor now rotates and disappears when IR is not pointed to the IR sensor (thanks ebool)
  • Added about and controls icon
  • Added functionality to remove old files that some applications don't use when you update
  • Added statistics gathering which will be displayed on a webpage
  • Changed IP address from wiiregionworld.com to codemii.com

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
  • Allow users to change the default icon
  • 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
  • Use 7z files instead of downloading each individual file
  • Have an update all button to update all applications
  • Increase font size
  • Use threading to download files so that you can do other things whilst downloading
  • Add controller images to each application

Credits

  • LowLines for the Homebrew Browser logo, HBC icon and all other graphics
  • joedj for network code in ftpii
  • Tantric - Used unzip library
  • 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.