The Wii-Linux is a small Linux OS for the Wii, based on GC Linux.
- 1 Summary
- 2 Getting Started
- 3 Logging in
- 4 Things that work
- 5 Things that Don't Work
- 6 Hardware Compatibility
- 7 Troubleshooting
- 8 GUI
- 9 Releases
- 10 External links
- Creator: GC-Linux Team
- Software type: Operating System
- Accessories needed: Computer running Linux, SD card with a FAT16 and an ext3 partition, USB keyboard
- Optional accessories: GameCube controller, USB Gecko, Wiimote, Nintendo Wii LAN Adapter, USB drive
- Best PAL mode: 480i/p
- Loaders usable: Twilight Hack, Homebrew Channel
- Button to return to loader: No
- Alternate installation: Setup USB gecko and load the software on the PC beforehand (see the readme).
The Whiite Installer
- The GC-Linux.org team has released a new installer for certain distros including:
Isobel has made some Official Instructions.
- 1. Make a second partition on your SD card and format as ext3.
- 2. Extract the debian-etch-4.0+whiite-0.1.tar.bz2 package to the ext3 partition of your SD card. You must extract the package as root or sudoer if you are using Linux or else files under
/devwill not appear correctly.
- 3. Copy the whiite-linux folder from the whiite-linux-0.1a.tar.bz2 archive to
/apps/for HBC or put the boot.elf on the root for the TP-Hack.
- 4. Load the file using TP-Hack or HBC.
- 5. Log in to access the terminal. You can now run commands and navigate directories.
- 6. Configure bluetooth with
hcitool scanand press 1+2 on your wiimote to connect it.
After you have booted Linux you will have 60 minutes to log on with the credentials below before it times out.
- For debian-etch-4.0+whiite-0.1:
Username: root Password: whiite
- For POC:
Username: root Password: cube
Things that work
The Debian release comes with a lot of news, only available if you boot using the kernel that comes with that package. You will need a USB keyboard to use this release. If you are able to boot with it and login, you will stop in a command line where you can navigate through the filesystem, and execute some applications. There are working drivers for the USB bus and internal bluetooth, but not for the internal wireless adapter. Here are some things that you can do:
Edit text files
nano [text file]
mp3-decoder <mp3 file>
There is an mp3 sample in the /root directory. You can play it if you type:
You can also use this:
mpg321 <mp3 file>
Type & after the command to have the mp3 play in the background:
mpg321 Synapse-Stealing_Science.mp3 &
To play MP3s from a USB drive, mount the drive (see below). Navigate to the directory where they are stored on your USB stick, and use the "mp3-decoder" or the "mpg321" tool to play them.
Mount USB Drives
- Mount an external USB hard disk
Not all USB hard disks work, but if they are formatted in FAT or EXT2 they might be recognized. Connect a pendrive to the USB, and type:
The dmesg command will show you the last kernel message. If the pendrive is compatible, it will show you some debug messages, and a message with the status of the new drive. If it is recogniced as sda, you can mount and navigate to that using these commands:
mkdir mnt mount /dev/sda1 mnt cd mnt ls
- To show the identifiers of the devices connected to the USB: Type
- USB hubs work.
Use the internal bluetooth
There is a driver that manages the Wii internal bluetooth. You can connect to the wiimote, but there isn’t any application to manage it yet. You can type these commands to configure it:
- Shows you the bluetooth configuration.
hcitool scanand press "1&2" on the wiimote
- This will find the wiimote and show some information.
Chat on IRC
Install Debian Packages
If you find a USB network adapter that works with this kernel such as the Nintendo USB network adapter, you will be able to install new Debian packages directly onto the Wii using apt-get. Or you can download on a PC then use dpkg to install packages manually.
- cmatrix is confirmed to run which displays a simple curses screensaver. The font suggested for it has not been tested.
- ninvaders is a simple curses based game played like Space Invaders. Seems to work 100%
- pacman is a curses pacman game. Currently the Linux console is not large enough to view the lives, levels, and score. The game is compiled from scratch with wiiuse and bluetooth and ncurses devs.
If you would like the source for pacman with wiimote support check out my website. --Skibur 22:53, 21 July 2008 (CEST)
- sc is a curses spreadsheet application.
- Download the source to Wii MFE
- Copy these files to the corresponding places on your SD card:
/src/native/fs/shipped/lib/ /src/native/fs/shipped/root/ /src/native/fs/shipped/usr/
- Extract the contents of these archives to your SD card:
- Log on to whiite and type (you only need to do this once):
mknod /dev/fb0 c 29 0
Things that Don't Work
Wii Linux currently does not support the Wii's built-in WiFi, even though the drivers for this device are built into the Linux kernel.
Compatible ethernet adapters
|Device||Hardware ID String||Description||Cost|
|Nintendo Wii LAN Adapter||Official Nintendo Product||$24.99 US|
|Datel's LAN Adapter||$29.90|
Incompatible ethernet adapters
|Device||Hardware ID String||Description|
|Linksys USB Network Adapter USB10T||VID_0x066b & PID_0x2206||device not supported|
- I get a black screen when I load the DOL.
- Something is wrong with the filesystem format your SD card and try again.
- It boots up with a lot of errors saying file system read-only then it freezes.
- Turn off Wiiconnect24 or load from TP-Hack.
- A GUI is still needed.
- There is a work in progress project to create an Xorg driver for Wii/Gamecube. You can download and find more information here:
- XORG is available!
- KDE in the near future?
No current releases yet support the wii's wireless networking capabilities. This means, that if you want to access the internet or another aspect of your network, you will need a wii usb-to-ethernet adapter.
It is also possible to setup a Bluetooth network connection, provided that you have another Linux PC with Bluetooth support nearby.
- Seems similar to bertjan's but was announced first, * It can be installed normally like any other homebrew app (no partitioning needed), and includes many more features. Including the following:
- An easy way to switch between TV types (although it does require a restart)
- The ability to install a disk image directly onto a normal partition on an SD card or USB drive, meaning absolutely no partitioning or anything.
- Many, many more apps
- An easy-to-use media mounter
- Contributions from many users
- A pretty screensaver
- Probably a lot more that I forgot to list
- It was momentarily leaked but it was soon, for lack of a better term, unleaked.
- A release is expected within the next few weeks.
- After it is released, bertjan has said he will abandon his own distribution and contribute to this one instead.
- For progress updates, see http://hbcapps.com/miight/blog. For older posts see http://tehum.blogspot.com, a blog I shared with someone else when I couldn't be bothered to get my own.
- Made by Muzer
- A full Gentoo distro for the wii.
- It uses the whiite method of installation.
- Made by T7g
- Arch Linux PPC for the Wii
- Designed for use with the new MIKE p1 kernel but can be made to work with Boot it or any other kernel release.
- Made By TheStorm/JonimusPrime and zc00gii
- Is designed for more advanced users to create from scratch but minimal and X11 file-system tars are available
- The X11 tar has XORG installed along with the OpenBox3 WM and Cwiid for Wiimote input
- It also includes the Opera Browser, X-Chat IRC client and Pidgin IM client
- The Minimal image is jsut enough to get you booted and the end user can install any packages they wish using pacman
- File-system tars can be found here
- Whiite but with the XORG environment successfully implemented.
- It currently uses kernel 2.6.27b.
- It also includes some applications including FireFox.
- It uses the whiite method of instalation
- It has now been updated to v0.2
- Made by bertjan
- New drivers with SDHC support, and optimized memory. Updated versions (2.6.27a & 2.6.27b) are also available.
- Just replace your current boot.elf/dol with this(for any whiite-linux-method distros).
- Based on Debian etch 4.0
- Major update with many new apps and features.
- Currently, only v0.1 is available.
These are small, stand-alone distros that were merely to demonstrate that linux could run on the wii. These distros are very limited in functionality and are not recommended. Instead, use one of the above distros (XWhiite, Bliight are recommended).
Proof of Concept 0.4
Proof of Concept 0.3
- Adds read and write support for the front SD card slot.
Proof of Concept 0.2
Proof of Concept 0.1
- A video showing a playable pacman console game with wiimote support
- A video showing how wii-linux debian boots, with some features and applications
- A video showing T2 SDE 6.0 linux booting from an external HDD using the SD card as pivot root. X runs!
- A video showing T2 SDE 6.0 linux booting from an external HDD using a ramdisk card as pivot root. In this video the xserver works with a driver for Wii/Gamecube and has correct colours
- The Official GC-Linux SourceForge Page
- TehSkeen Forums
- Muzer's Miighty Blog