Homebrew Browser

From WiiBrew
Jump to navigation Jump to search
Homebrew Browser
Homebrew Browser Icon.png
General
Author(s)teknecal
TypeUtility
Version0.3.5
LicenceFreeware
Links
Download
Website
Peripherals
Wiimote1.svg SensorBar.svg GameCube Controller Loads files from the Front SD slot Loads files from SDHC cards in the Front SD slot USB mass storage device Internet


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.

Keep up to date with weekly notification emails, add hbb@codemii.com to your Wii address book to get weekly 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 Question Mark - You might not have the latest version of that homebrew application installed.
Wiimote.svg GameCube Controller Action
Wii Remote Aim GameCube Control Stick Move Pointer
Wiimote A Button Gamecube A Button Click button
Wiimote B Button Gamecube B Button Cancel download/extract
Wiimote D-Pad Left / Wiimote D-Pad Right Gamecube D-Pad Left / Gamecube D-Pad Right Previous/Next category
Wiimote D-Pad Up / Wiimote D-Pad Down Gamecube D-Pad Up / Gamecube D-Pad Down Scroll up and down the list slowly
Wiimote - Button Wiimote + Button GameCube L Trigger / GameCube R Trigger Remove/Add application to download queue
Wiimote HOME Button GameCube START Button Menu
Wiimote 1 Button ? Work offline
Wiimote 2 Button ? Revert to CodeMii repository

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 apps/homebrew_browser/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.

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.

Homebrew Standards

  • Include an icon.png and a meta.xml file with your homebrew application. Make sure the icon.png file dimensions is 128 x 48.
  • 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 or v1.0.
  • 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. (Hosting problems)

Date Added Application
7 September 2009
3 September 2009
31 August 2009
26 August 2009
23 August 2009
20 August 2009
15 August 2009
  • Chunk Munch v0.5
  • ShootMii v0.8.7
  • WiiXplorer Pre Alpha r27
11 August 2009
9 August 2009
7 August 2009
4 August 2009
1 August 2009
29 July 2009
25 July 2009
21 July 2009
17 July 2009
14 July 2009
12 July 2009
  • MiiSX v0.2
  • WiiSPACE v1.2
10 July 2009
7 July 2009
4 July 2009
1 July 2009
28 June 2009
  • BootMii Configuration Editor v1.1
  • FMyLife v0.2
  • GuitarsOnFire v0.1a
  • WiiSPACE v1.0
21 June 2009
14 June 2009
13 June 2009
10 June 2009
5 June 2009
3 June 2009
31 May 2009
30 May 2009
28 May 2009
  • Balance Board Tools v0.9
  • Goblin's Cube v1.0.0
  • Kidspaint v1.3
  • OpenTyrianWii v1.1.1
  • Wii7800 v0.1
26 May 2009
  • Bowfishing Action! v1.0
  • FCEU v3.0.3
  • MPlayer Christmas Edition v0.61
  • OpenTyrianWii v1.1.0
  • Snes9xGX v4.0.5
  • Visual Boy Advance v2.0.2
24 May 2009
22 May 2009
20 May 2009
17 May 2009
  • WiiRadio v0.3
  • Wolfenstein 3D Wii v1.2a
16 May 2009
15 May 2009
  • DOSBox Wii v0.72.01
  • Hexxagon v1.0
  • Playstats v1.01
  • Wiituka v0.98.6
12 May 2009
  • iiii v2.0
  • Quake v0.09
6 May 2009
4 May 2009
2 May 2009
  • Snes9xGX v4.0.3
  • FCEU v3.0.2
  • Quake v0.06
  • Super Mario War Wii v1.1
  • Visual Boy Advance v2.0.1
30 April 2009
  • GeckoOS v1.9.0.1
  • Kidspaint v1.2
  • ScummVM v0.13.1
  • Super Mario War Wii v1.0
27 April 2009
24 April 2009
19 April 2009
15 April 2009
  • FCEU v3.0.0
  • GeckoOS v1.8
  • Kidspaint v1.0
  • ONScripter v04.2009a
  • Snes9xGX v4.0.1
12 April 2009
  • iiii v1.2+
  • Visual Boy Advance v1.0.9
  • ONScripter v04.2009
8 April 2009
3 April 2009
28 March 2009
21 March 2009
14 March 2009
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
  • bibleQuiz v0.91
  • Helium Boy v0.1
  • Liightsout! v1.0beta4
  • Pong2 v0.97
  • SpaceBubble v0.6
  • Wiibreaker v0.5
  • Wii Quizz v1.9</s.
1 February 2009
29 January 2009
  • FCEU v2.0.9
  • Frodo v6
  • FUSE vSnapshot3
  • Snes9xGX v009
  • SpaceBubble v0.50
  • Splatter Castle v2009.01.27
  • Visual Boy Advance v1.0.7
  • Wii Handy SDL v0.2
  • WiiLander v0.42
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
  • GeckoOS v1.07b
  • Snes9xGX v005
  • Wiibreaker v0.1
  • WiiDoom v0.3
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

31 August 2009 (v0.3.5) - Added repositories functionality - Redid SD/USB mounting method so it keeps trying to at least mount one of these - Cleaned up the text being printed a bit

9 August 2009 (v0.3.4)

  • Fixed issue with icons not being loaded, removing an application from the queue bug and updated meta.xml handling when updating HBB

25 July 2009 (v0.3.3)

  • Speed up extracting using updated libfat (speeds up download too, but it's not noticeable)
  • Added USB support (plug in your USB device before booting HBB and turn off "Use SD" in settings)
  • Added sorting of applications by name
  • Added delete functionality to the queue (press minus to queue an application to be deleted)
  • Added download and extract information (MB downloaded/MB total, Extracted files/Files to extract)
  • Added a check to make sure Wii Network is initialised and active before downloading applications
  • Fixed bug where you couldn't cancel the download queue if you had download prompt enabled
  • Fixed bug where the meta.xml file name would change back to normal when you updated an application (this allows you to keep your custom name of applications)

2 June 2009 (v0.3.2)

  • Added an updated applications pop-up which can be disabled in the setting. When applications are updated, you will be notified of the date, application and version when starting HBB.
  • Added number of Wiimotes supported by applications by showing the number in the Wiimote icon
  • Can revert to using IP address if HBB can't find codemii.com domain
  • Added a download icon to indicate which application is being downloaded when you are browsing whilst downloading
  • Added setting to disable Wiimote power off as some users experienced their Wii's turning off automatically
  • Fixed bug where download/delete buttons would show when rating an application
  • Fixed an issue when deleting applications wouldn't delete some folders
  • Fixed squares that occasionally showed after name, description, etc which would cause creating/deleting directories to fail
  • Fixed download queue issue when removing applications from the queue
  • Fixed code dumps that occurred when scrolling the lists

1 May 2009 (v0.3.1)

  • Able to download and browse at the same time (just click on a category when downloading)
  • Fixed bug which didn't show the last character for applications names, descriptions, etc.
  • Fixed bug where the wrong applications were shown after downloading from download queue
  • Added GC controller support (port #1)
  • Added Nunchuk support for scrolling the apps list
  • Added ability to power off the Wii via the Wiimote power button
  • Menu items are now accessible when in the help or settings screen

12 April 2009 (v0.3)

  • Brand new GUI (thanks DayDreamOz)
  • Ability to scroll through applications without waiting to download images (images loading or being downloaded will show as "Image not found")
  • Images down