In memory of Ben “bushing” Byer, who passed away on Monday, February 8th, 2016.

Difference between revisions of "Wii-Linux"

From WiiBrew
Jump to navigation Jump to search
(Update Wii Linux Continuation Project details)
 
(71 intermediate revisions by 21 users not shown)
Line 1: Line 1:
 +
{{Seealso|Wii-Linux/Distros}}
 
{{Infobox homebrew
 
{{Infobox homebrew
 
| title      = Wii-Linux
 
| title      = Wii-Linux
Line 11: Line 12:
 
| peripherals = {{Wiimote1}} {{GCNController}} {{USBKeyboard}} {{FrontSD}} {{USBMSD}} {{USBGecko}}
 
| peripherals = {{Wiimote1}} {{GCNController}} {{USBKeyboard}} {{FrontSD}} {{USBMSD}} {{USBGecko}}
 
}}
 
}}
'''''Wii-Linux''''' is the generic name for GC-Linux based systems that run on the Wii, and support the Wii's extra hardware (as compared to the GameCube).  Many "distributions" are available -- a pairing of a kernel with a userland -- but most can be considered experimental.
 
  
== Summary ==
+
'''Please note:''' The current kernel builds/code patches at gc-linux.org quite dated and it seems they are no longer being actively maintained by the original authors. However, since January 2013 someone else has continued development here [https://github.com/DeltaResero/ [1]]].  Unfortunately, even this project seems to no longer be active.  As such, [[Wii-Linux#Wii Linux Continuation Project|another continuation project]] has appeared that is still active as of May 31st, 2024.
*Creator: GC-Linux Team
 
*Software type: Operating System
 
*Accessories needed: Storage for a root filesystem (SD card with a FAT16 and an ext3 partition or a USB drive), USB keyboard
 
*Optional accessories: Computer running Linux, GameCube controller, [[USB Gecko]], Wiimote, [[Wii-Linux#Compatible Ethernet adapters|Nintendo Wii LAN Adapter]], [[Wii-Linux#Mount USB Drives|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).
 
  
== Hardware supported ==
 
At this point, the Linux kernel itself can talk to most of the major peripherals -- Wiimotes, WiFi, USB, Bluetooth, GameCube controllers, USBGecko, DVD drive, etc.  Actual support will vary with the software installed on the root partition.
 
  
== Getting Started ==
+
'''Wii-Linux''' or '''GC-Linux''' is a port of the [http://en.wikipedia.org/wiki/Linux Linux] kernel and related [http://en.wikipedia.org/wiki/GNU_Core_Utilities GNU userspace utilities] to the [http://en.wikipedia.org/wiki/Wii Nintendo Wii video game console]. Many [http://en.wikipedia.org/wiki/Linux_distribution distributions of GNU/Linux] are available for the Wii. All current distributions use a version of the "gc-linux" kernel, a port of the [http://en.wikipedia.org/wiki/Linux_kernel Linux kernel] by the [http://www.gc-linux.org/wiki/Main_Page GC-Linux project].
In broad strokes, you will create an ext3 filesystem on some removable device (SD card, USB drive) and then boot a kernel image ELF.
 
  
=== The Whiite Installer ===
+
Wii-Linux may be loaded through the [[Homebrew Channel]] but is recommended to be loaded through [[bootmii]]/[[Mini]] to enable Wi-Fi and USB2.0 support.
*The GC Linux team has released a new installer for certain distributions including:
 
**Bliight
 
**XWhiite
 
**Whiite
 
*[http://www.tehskeen.com/viewarticle.php?articleid=3101 Download/Discussion]
 
  
=== Manual Installation ===
+
The kernel itself can communicate with nearly all Wii peripherals; Wii Remotes, Wi-Fi, USB, Bluetooth, GameCube controllers, USBGeckos and the DVD drive are supported. GameCube Memory Cards are currently unsupported.
Isobel has made some [http://www.gc-linux.org/wiki/WL:whiite-linux Official Instructions].
+
 
 +
The GC-Linux kernel can run under [[IOS]], Nintendo's official operating system that runs on the Wii's [[Starlet]] coprocessor, while other versions run under the alternate operating system by [[Team Twiizers]] known as mini or "[[Mini]]" (which stands for '''M'''INI '''I'''s '''N'''ot '''I'''OS)
 +
 
 +
MINI has some advantages over IOS: full and complete access to Wii internal hardware, such as Wi-Fi, USB2.0, the DVD Drive. See [http://www.gc-linux.org/wiki/Wii:Hardware_Support here].
 +
 
 +
The IOS-based kernels can be loaded through the [[Homebrew Channel]], or the [[Twilight Hack]]. But MINI-based kernels must be loaded through MINI (which means "[[BootMii]]" must be installed). BootMii can be installed in two ways. First in [[boot2]] (where the Wii powers up into BootMii) or second in IOS (where BootMii is loaded through the Homebrew Channel). Confusing, but this is current the state of Wii homebrew.
 +
 
 +
The latest version of GC-Linux is [http://www.gc-linux.org/wiki/MINI:KernelPreviewFive#.27Mini.27_Kernel_Preview_Five_.28aka_MIKE_p5.29 MIKEp5] (which stands for '''MI'''NI '''Ke'''rnel '''P'''review '''Five'''). The MIKEp5 kernel has an IOS and MINI version available.
 +
 
 +
== Hardware Required ==
 +
 
 +
* Nintendo Wii Console ([[Homebrew Channel]] or an alternate loader installed. [[bootmii]] installed in boot2 and/or ios)
 +
* SD Card (Will be formatted. 512MB Required. 2GB Recommended)
 +
* USB Keyboard
 +
 
 +
Note: A computer already running Linux is useful for manual installation.
  
#Make a second partition on your SD card and format as ext3.
+
Note: The SD Card or USB Drive will likely be formatted and repartitioned.
#*If you are not using Linux and you are encountering problems you can try the [http://gparted.sourceforge.net/livecd.php GParted Live CD] or [http://www.ubuntu.com/getubuntu/download Ubuntu 8.04 Live Desktop] which contains GParted. The [http://www.nacionarcade.net/wp-content/uploads/2007/11/mameonwii.doc Mame on Wii] guide explains how to format an SD card using this CD.
 
#*Linux users can follow the [http://www.gc-linux.org/wiki/WL:whiite-linux#Preparation_of_the_SD_card whiite-linux] instructions to prepare the SD card.
 
#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 <code>/dev</code> will not appear correctly.
 
#Copy the whiite-linux folder from the whiite-linux-0.1a.tar.bz2 archive to <code>/apps/</code> for HBC or put the boot.elf on the root for bannerbomb.
 
#Load the file using bannerbomb or HBC.
 
#Log in to access the terminal. You can now run commands and navigate directories.
 
#Configure Bluetooth with <code>hciconfig</code> then type <code>hcitool scan</code> and press 1+2 on your wiimote to connect it.
 
  
== Logging in ==
+
== Installing ==
After you have booted Linux you will have 60 minutes to log on with the credentials below before it times out.
+
===Whiite-Linux Installer ===
 +
The GC-Linux team has released a [http://web.archive.org/web/20230527055421/http://www.gc-linux.org/wiki/WL:whiite-linux-installer Simple GUI-based installer] can be used with Whiite, Bliight and XWhiite distributions. The installer can be loaded via the [[Homebrew Channel]] or [[Twilight Hack]].  Note that these instructions are for a very old version of Debian Linux which predates the version 5.0 mentioned in here.
  
*For debian-etch-4.0+whiite-0.1:
+
An ext3 filesystem is created on a removable disk (SD card or USB drive). The kernel image ELF can be loaded through [[Homebrew Channel]]. It is recommended to replace the kernel image ELF with the compatible MIKE (MIni KErnal) ELF binary. This will enable Wi-Fi and the DVD drive to be used. The latest MIKE version is currently [http://www.gc-linux.org/wiki/MINI:KernelPreviewFive MIKEp5].
    Username: root
 
    Password: whiite
 
*For PoC:
 
    Username: root
 
    Password: cube
 
  
== Things that work ==
+
=== Manual Installation ===
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:
+
Users may install a Wii-Linux distribution manually. Isobel has written the [http://www.gc-linux.org/wiki/WL:whiite-linux#Manual_Installation official instructions] for manual installation.
  
=== Edit text files ===
+
== Using Wii-Linux ==
    nano [text file]
+
{{Main|Using Wii-Linux}}
  
=== Play MP3s ===
+
Once a Wii has booted Linux, there are lot's of things for users new to Linux to do.
    mp3-decoder <mp3 file>
 
  
There is an mp3 sample in the /root directory. You can play it if you type:
+
* A [http://en.wikipedia.org/wiki/Graphical_user_interface GUI] is available, in the form of an [http://en.wikipedia.org/wiki/X.Org_Server X.org server]. Although it is ''not'' optimized for a [http://en.wikipedia.org/wiki/10-foot_user_interface "10-foot user interface"], like that found in the [http://en.wikipedia.org/wiki/Wii_Menu Wii Menu]. A Wii Remote may be used as a pointing device with the X.org server, but manual configuration is needed. (See xwhiite)
    mp3-decoder Synapse-Stealing_Science.mp3
 
  
You can also use this:
+
*It's possible for a Wii to powerup directly into Wii-Linux. BootMii must be installed in boot2 for this feature. To enable this, replace the file /bootmii/ppcboot.elf (on the front SD Card) with the GC-Linux kernel of your choice (Remember to back up the original ppcboot.elf somewhere!!)
    mpg321 <mp3 file>
 
  
Type & after the command to have the mp3 play in the background:
+
== Hardware Compatibility ==
    mpg321 Synapse-Stealing_Science.mp3 &
+
{{Main|Wii-Linux Hardware Compatibility}}
  
To play MP3s from a USB flash drive, mount the drive (see below). Navigate to the directory where they are stored on your USB flash drive, and use the "mp3-decoder" or the "mpg321" tool to play them.
+
Before Wii-Linux supported internal Wi-Fi, users were forced to use USB Ethernet Adapters and USB Wi-Fi dongles for an Internet connection. Supported external hardware is listed.
  
=== Mount USB Drives ===
+
Note that currently all internal "native" Wii hardware is supported. Some classic hardware (such as GameCube Memory Cards) are still unsupported. A full list of supported hardware is available [http://www.gc-linux.org/wiki/Wii:Hardware_Support here].
* 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 USB flash drive, and type:
 
  dmesg
 
  
The dmesg command will show you the last kernel message. If the USB flash drive is compatible, it will show you some debug messages, and a message with the status of the new drive. If it is recognized as sda, you can mount and navigate to that using these commands:
+
Also note that [http://en.wikipedia.org/wiki/NDISwrapper NDISwrapper] is '''not''' available for Wii-Linux since the Nintendo Wii uses a [http://en.wikipedia.org/wiki/PowerPC PowerPC]-based CPU (NDISwrapper does not have a PPC version and it would take a lot of work to port it)
  mkdir mnt
 
  mount /dev/sda1 mnt
 
  cd mnt
 
  ls
 
  
*To show the identifiers of the devices connected to the USB: Type <code>lsusb</code>
+
== Troubleshooting ==
*USB hubs work.
+
{{Main|Troubleshooting Wii-Linux}}
  
=== Use the internal Bluetooth ===
+
For frequent problems when installing and setting up Wii-Linux
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:
 
  
; <code>hciconfig</code> : Shows you the Bluetooth configuration.
+
== Distributions ==
; <code>hcitool scan</code> and press "1&2" on the Wiimote
+
{{Main|Distributions of Wii-Linux}}
: This will find the Wiimote and show some information.
 
  
=== Chat on IRC ===
+
Many distributions of GNU/Linux are available for the Nintendo Wii.
    irssi
 
  
=== Install Debian Packages ===
+
=== Ubuntu 14.04.5 ===
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.
+
*Ubuntu PPC for the Wii
 +
*Designed to be as easy as flash and boot.
 +
*Made By Wiibuntu
 +
*TERMINAL ONLY! NO DESKTOP ENVIROMENT!
 +
*Downloads and .tar's found [https://github.com/Wiibuntu/Ubuntu14-Wii here.]
 +
*Last updated: 12 March 2024
  
*[http://packages.debian.org/etch/cmatrix cmatrix] is confirmed to run which displays a simple curses screensaver. The font suggested for it has not been tested.
+
=== Ubuntu Server 13.10 ===
*[http://packages.debian.org/etch/ninvaders ninvaders] is a simple curses based game played like Space Invaders. Seems to work 100%
+
*Ubuntu PPC for the Wii
*[http://doctormike.googlepages.com/pacman.html 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.
+
*Designed to be as easy as flash and boot.
*[http://packages.debian.org/etch/sc sc] is a curses spreadsheet application.
+
*Made By Wiibuntu
 +
*Downloads found [https://github.com/Wiibuntu/Ubuntu-13.10-Wii here.]
 +
*Last updated: 11 March 2024
  
=== Install MPlayer ===
+
=== xUbuntu 9.04 ===
*Download the source to [[Wii MFE Port]]
+
*xUbuntu PPC for the Wii
*Copy these files to the corresponding places on your SD card:
+
*Designed to be as easy as flash and boot.
/src/native/fs/shipped/'''lib/'''
+
*Made By Wiibuntu
/src/native/fs/shipped/'''root/'''
+
*xorg already installed along with xfce4
/src/native/fs/shipped/'''usr/'''
+
*All repository's are set to old-releases already
*Extract the contents of these archives to your SD card:
+
*Downloads and .tar's found [https://github.com/Wiibuntu/Xubuntu-9.04-Wii/tree/main here.]
/src/native/libsdl/'''mfe-libsdl.tar.gz'''
+
*Last updated: 7 February 2024
/home/zach/Desktop/src/native/mplayer/'''mfe-mplayer.tar.gz'''
 
*Log on to whiite and type (you only need to do this once):
 
  mknod /dev/fb0 c 29 0
 
*Type:
 
  mplayer <file>.avi
 
  
== Things that Don't Work ==
+
=== Wii-Linux-NGX ===
The latest [http://www.gc-linux.org/wiki/MINI:KernelPreviewFive Mini Kernel Preview Five] does not support Nintendo GameCube memory cards.
+
*Based on Debian Jessie 8.0
 +
*Made by [https://github.com/neagix neagix], who keeps the repository for the distribution on github
  
== Hardware Compatibility ==
+
Includes several different branches of implementations of the GNU/Linux kernel:
=== Compatible Ethernet adapters ===
 
{|class="wikitable"
 
! Device
 
! Hardware ID String
 
! Description
 
! Cost
 
|-
 
| [http://store.nintendo.com/webapp/wcs/stores/servlet/ProductDisplay?productId=117712&currency=USD&catalogId=10001&categoryId=62707 Nintendo Wii LAN Adapter]
 
|
 
| Official Nintendo Product
 
| [http://store.nintendo.com/webapp/wcs/stores/servlet/ProductDisplay?productId=117712&currency=USD&catalogId=10001&categoryId=62707 $24.99 US]
 
|-
 
| Datel's LAN Adapter
 
|
 
|
 
| [http://www.play-asia.com/paOS-13-71-10v-49-en-70-1slw.html $29.90]
 
|-
 
| Linksys WUSB54GC USB Wi-Fi Adapter
 
|
 
|
 
| [http://www.newegg.com/Product/Product.aspx?Item=N82E16833124350 $24.99]
 
|-
 
| [http://www.linksysbycisco.com/US/en/products/USB200M Linksys USB200M rev 2]
 
|
 
|
 
|
 
|-
 
| ASIX AX88172
 
| 0b95:1720
 
| USB2.0 to 10/100M Fast Ethernet Controller
 
|
 
|}
 
  
=== Incompatible Ethernet adapters ===
+
*[https://github.com/neagix/linux/tree/stable-v3.x stable-v3.x], latest working v3.x kernel with most up to date upstream patches
{|class="wikitable"
+
*[https://github.com/neagix/linux/tree/experimental-v3.x experimental-v3.x], some features might be broken (SDHC)
! Device
+
*[https://github.com/neagix/linux/tree/experimental-v4.x experimental-v4.x], some features might be broken (SDHC)
! Hardware ID String
 
! Description
 
|-
 
| [http://www.superclearance.com/shop/image.php?productid=44905 Linksys USB Network Adapter USB10T]
 
| VID_0x066b & PID_0x2206
 
| device not supported
 
|-
 
| [http://www.eminent-online.com/producten_stap2.php?dt=1&ps=01304090&pg=99 Eminent EM4090 USB Network Kit]
 
|
 
|
 
|}
 
  
== Troubleshooting ==
+
Current working features:
;I get a black screen when I load the DOL.
 
:Something is wrong with the SD card's filesystem. Format your SD card and try again.
 
  
;It boots up with a lot of errors saying file system read-only then it freezes.
+
*WiFi
:Turn off Wiiconnect24 or load from bannerbomb (please confirm).
+
*Reading DVD-ROMs
 +
*Xorg (using the framebuffer)
  
== GUI ==
+
Last Update: 6 September 2017.
An X.org server is available for the Wii, but little has been done to create a "Wii-appropriate" user interface with it.  A Wiimote may be used as a pointing device, but manual configuration is often needed to set this up.
 
  
== Distributions ==
+
=== Whiite ===
 +
[http://www.gc-linux.org/wiki/WL:whiite-linux#Introduction Whiite-linux] is a Debian 5.0 (lenny) based Linux distribution for the Nintendo Wii.
 +
*Wifi, USB2.0 and DVD drive support when running with [http://www.gc-linux.org/wiki/MINI:KernelPreviewFive MikeP5]
 +
*Easy Wifi configuration tool in /root/ to run type ./whiite-ez-wifi-config
 +
*[http://sourceforge.net/projects/gc-linux/files/wii-linux/whiite-linux-1.10/debian-lenny-5.0%2Bwhiite-1.10.tar.bz2/download Version 1.10 (Debian Lenny 5.0) Download]
 +
*Currently uses kernel [http://www.gc-linux.org/wiki/MINI:KernelPreviewFive 2.6.32]
 +
*Written by the gc-linux team.
 +
*Last updated: 21 Oct 2009
  
 
=== WiiToo! ===
 
=== WiiToo! ===
[[WiiToo!]] is a minimal precompiled stage4 made to let you run [http://www.gentoo.org/ Gentoo] on your Wii using [http://www.gc-linux.org/wiki/MINI:KernelPreviewFour MIKE] and [[Mini]]. It provides all the basic software required to compile and install new programs on it, and some other software ready to be used. The kernel used is plain vanilla-sources & [[Wii-Linux]] patches, so expect WiFi working out of the box.
+
[[WiiToo!]] is a minimal precompiled stage4 made to let you run [http://www.gentoo.org/ Gentoo] on your Wii using [http://www.gc-linux.org/wiki/MINI:KernelPreviewFour MIKE] and [[Mini]]. It provides all the basic software required to compile and install new programs on it, and some other software ready to be used. The kernel used is plain vanilla-sources & [[Wii-Linux]] patches, so expect WiFi working out of the box.
 
*Ready to use, uncompress, copy, configure and run
 
*Ready to use, uncompress, copy, configure and run
 
*Highly configurable, like Gentoo
 
*Highly configurable, like Gentoo
Line 195: Line 135:
 
*Can use all the hardware that Wii-Linux is able to use
 
*Can use all the hardware that Wii-Linux is able to use
 
* Last update: 29 October 2009
 
* Last update: 29 October 2009
 
=== Whiite ===
 
*Based on Debian Lenny 5.0
 
*Major update with many new apps and features
 
*Wifi Support when running with [http://www.gc-linux.org/wiki/MINI:KernelPreviewFour MikeP4]
 
*DVD Support when running with [http://www.gc-linux.org/wiki/MINI:KernelPreviewFive MikeP5]
 
*Easy wifi config tool (in /home/wii/)
 
*[http://sourceforge.net/projects/gc-linux/files/wii-linux/whiite-linux-1.10/debian-lenny-5.0%2Bwhiite-1.10.tar.bz2/download Version 1.10 (Debian Lenny 5.0) Download]
 
*[http://downloads.sourceforge.net/gc-linux/debian-etch-4.0%2Bwhiite-0.1.tar.bz2 Version 0.1 (Debian Etch 4.0) Download]
 
*Last updated: 21 Oct 2009
 
 
=== Miight ===
 
*Now exists again.
 
*Designed to be a full distribution for noobs
 
*Will be released soon, with Miight 2.0 following some time in the future
 
*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 flash drive, meaning absolutely no partitioning or anything (hopefully).
 
**Many, many more apps
 
**An easy-to-use media mounter
 
**Contributions from many users
 
**Supertux
 
**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.
 
*After it is released, bertjan has said he will abandon his own distribution and contribute to this one instead.
 
*First public beta version is hopefully going to be released in the end of January
 
*Miight 2.0 will be released after the 1.0 and will be a complete rewrite
 
*For progress updates, see [http://hbcapps.com/miight/blog http://hbcapps.com/miight/blog]. For older posts see [http://tehum.blogspot.com http://tehum.blogspot.com], a blog I shared with someone else when I couldn't be bothered to get my own.
 
*Made by [[User:Muzer|Muzer]]
 
  
 
=== Archii ===
 
=== Archii ===
Line 231: Line 141:
 
*Made By TheStorm/JonimusPrime and zc00gii
 
*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
 
*Is designed for more advanced users to create from scratch but minimal and X11 file-system tars are available
**The X11 tar has X.Org installed along with the OpenBox3 WM and Cwiid for Wiimote input
+
**The X11 tar has X.Org installed along with the OpenBox3 WM and Cwiid for Wii Remote input
 
**It also includes the Opera Browser, X-Chat IRC client and Pidgin IM client
 
**It also includes the Opera Browser, X-Chat IRC client and Pidgin IM client
 
**The Minimal image is just enough to get you booted and the end user can install any packages they wish using pacman
 
**The Minimal image is just enough to get you booted and the end user can install any packages they wish using pacman
*[http://wiki.archlinux.org/index.php/Wii_Tutorial ArchWiki-WiiTutorial]
+
*File-system tars can be found [http://jonimoose.net/archii/ here.]
*File-system tars can be found [http://thestorm.taricorp.net/archii/tarballs/ here]
 
 
*Last updated: 11 July 2009
 
*Last updated: 11 July 2009
 
=== Bliight ===
 
*A full Gentoo distribution for the Wii.
 
*It uses the whiite method of installation.
 
*Made by T7g
 
*[http://www.tehskeen.com/forums/showthread.php?t=9848 Download/Discussion]
 
*Last updated: 8 December 2008
 
  
 
=== XWhiite ===
 
=== XWhiite ===
 
*[[Wii Linux#Whiite|Whiite]] but with the X.Org environment successfully implemented.
 
*[[Wii Linux#Whiite|Whiite]] but with the X.Org environment successfully implemented.
*It currently uses [[Wii Linux#Kernel 2.6.27|kernel 2.6.27b]].
+
*It currently uses [[Wii Linux#Kernel 2.6.27|kernel 2.6.32]].
 
*It also includes some applications including Firefox.  
 
*It also includes some applications including Firefox.  
 
*It uses the whiite method of installation
 
*It uses the whiite method of installation
 
*It has now been updated to v0.2
 
*It has now been updated to v0.2
 
*Made by bertjan
 
*Made by bertjan
*[http://www.tehskeen.com/forums/showthread.php?t=9777 Download/Discussion]
+
*[https://mega.nz/#!O0tjXCrK!etpJQMHvTOzQtORQw_J8J1twOLXfo5O1cPQfEASLVZY v0.2 Download]
 
*Last updated: 02 December 2008
 
*Last updated: 02 December 2008
  
=== PoC ===
+
=== Wii Linux Continuation Project ===
These are small, stand-alone distributions that were merely to demonstrate that Linux could run on the Wii. These distributions are very limited in functionality and are not recommended. Instead, use one of the above distributions (XWhiite, Bliight are recommended).
+
*A kernel based on [[Wii-Linux#Wii-Linux-NGX|Wii-Linux-NGX]], with upgrades and patches
 
+
*Modern (2024) [https://github.com/kth5/archpower ArchPOWER]-based rootfs
==== Proof of Concept 0.4 ====
+
*Xorg can optionally be installed, and works properly, however does not come with the base system
*Adds support for USB keyboards through the IOS keyboard interface.
+
*Kernel previously updated by TheOtherOne, work continued by [[User:Techflash|Techflash]]
*[http://downloads.sourceforge.net/gc-linux/wii-linux-PoC-0.4.tar.gz Main Download]
+
*Includes a custom Linux text console based boot menu written in C to pick a distro to boot.
*[http://ostsoft.net/go?to=wiidl&dl=19 Mirrored Download]
+
*[https://wii-linux.org Website, including download links]
 
+
*[https://github.com/Wii-Linux All code relating to the project]
==== Proof of Concept 0.3 ====
+
*Last updated: 6 November 2024
*Adds read and write support for the front SD card slot.
 
*[http://downloads.sourceforge.net/gc-linux/wii-linux-PoC-0.3.tar.gz Download]
 
 
 
==== Proof of Concept 0.2 ====
 
*[http://downloads.sourceforge.net/gc-linux/wii-linux-PoC-0.2.tar.gz Download]
 
 
 
==== Proof of Concept 0.1 ====
 
*[http://downloads.sourceforge.net/gc-linux/wii-linux-PoC-0.1.tgz Download]
 
  
 
== External links ==
 
== External links ==
 
* A [http://www.youtube.com/watch?v=8hUSkOLWMZ8 video] showing '''Arch Linux on the Wii''' called, "Archii."
 
* A [http://www.youtube.com/watch?v=8hUSkOLWMZ8 video] showing '''Arch Linux on the Wii''' called, "Archii."
* A [http://www.youtube.com/watch?v=aiYbQfDhGKg video] showing a playable '''pacman console game with Wiimote support'''
+
* A [http://www.youtube.com/watch?v=aiYbQfDhGKg video] showing a playable '''pacman console game with Wii Remote support'''
 
* A [http://www.youtube.com/watch?v=XpDcnaeftsc video] showing '''how Wii-Linux Debian boots''', with some features and applications
 
* A [http://www.youtube.com/watch?v=XpDcnaeftsc video] showing '''how Wii-Linux Debian boots''', with some features and applications
 
* A [http://www.youtube.com/watch?v=v1UCQEMO8yc video] showing '''T2 SDE 6.0 Linux booting from an external HDD using the SD card as pivot root. X runs!'''
 
* A [http://www.youtube.com/watch?v=v1UCQEMO8yc video] showing '''T2 SDE 6.0 Linux booting from an external HDD using the SD card as pivot root. X runs!'''
 
* A [http://www.youtube.com/watch?v=2pvHvcq8qJ8 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'''
 
* A [http://www.youtube.com/watch?v=2pvHvcq8qJ8 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'''
* [http://www.gc-linux.org/ GC-Linux.org]
 
* [http://downloads.sourceforge.net/gc-linux/ The Official GC-Linux SourceForge Page]
 
*[http://hbcapps.com/miight/blog Muzer's Miighty Blog]
 
  
 
[[Category:Homebrew applications]]
 
[[Category:Homebrew applications]]

Latest revision as of 17:33, 6 November 2024

See also: Wii-Linux/Distros
Wii-Linux
Icon WiiLinux.png
General
Author(s)GC-Linux Team
TypeOperating system
Version1.10 (whiite)
LicenceMostly GPL
Links
Download
Website
Source
Peripherals
Wiimote1.svg GameCube Controller USB Keyboard Loads files from the Front SD slot USB mass storage device USBGecko2.svg

Please note: The current kernel builds/code patches at gc-linux.org quite dated and it seems they are no longer being actively maintained by the original authors. However, since January 2013 someone else has continued development here [1]]. Unfortunately, even this project seems to no longer be active. As such, another continuation project has appeared that is still active as of May 31st, 2024.


Wii-Linux or GC-Linux is a port of the Linux kernel and related GNU userspace utilities to the Nintendo Wii video game console. Many distributions of GNU/Linux are available for the Wii. All current distributions use a version of the "gc-linux" kernel, a port of the Linux kernel by the GC-Linux project.

Wii-Linux may be loaded through the Homebrew Channel but is recommended to be loaded through bootmii/Mini to enable Wi-Fi and USB2.0 support.

The kernel itself can communicate with nearly all Wii peripherals; Wii Remotes, Wi-Fi, USB, Bluetooth, GameCube controllers, USBGeckos and the DVD drive are supported. GameCube Memory Cards are currently unsupported.

The GC-Linux kernel can run under IOS, Nintendo's official operating system that runs on the Wii's Starlet coprocessor, while other versions run under the alternate operating system by Team Twiizers known as mini or "Mini" (which stands for MINI Is Not IOS)

MINI has some advantages over IOS: full and complete access to Wii internal hardware, such as Wi-Fi, USB2.0, the DVD Drive. See here.

The IOS-based kernels can be loaded through the Homebrew Channel, or the Twilight Hack. But MINI-based kernels must be loaded through MINI (which means "BootMii" must be installed). BootMii can be installed in two ways. First in boot2 (where the Wii powers up into BootMii) or second in IOS (where BootMii is loaded through the Homebrew Channel). Confusing, but this is current the state of Wii homebrew.

The latest version of GC-Linux is MIKEp5 (which stands for MINI Kernel Preview Five). The MIKEp5 kernel has an IOS and MINI version available.

Hardware Required

  • Nintendo Wii Console (Homebrew Channel or an alternate loader installed. bootmii installed in boot2 and/or ios)
  • SD Card (Will be formatted. 512MB Required. 2GB Recommended)
  • USB Keyboard

Note: A computer already running Linux is useful for manual installation.

Note: The SD Card or USB Drive will likely be formatted and repartitioned.

Installing

Whiite-Linux Installer

The GC-Linux team has released a Simple GUI-based installer can be used with Whiite, Bliight and XWhiite distributions. The installer can be loaded via the Homebrew Channel or Twilight Hack. Note that these instructions are for a very old version of Debian Linux which predates the version 5.0 mentioned in here.

An ext3 filesystem is created on a removable disk (SD card or USB drive). The kernel image ELF can be loaded through Homebrew Channel. It is recommended to replace the kernel image ELF with the compatible MIKE (MIni KErnal) ELF binary. This will enable Wi-Fi and the DVD drive to be used. The latest MIKE version is currently MIKEp5.

Manual Installation

Users may install a Wii-Linux distribution manually. Isobel has written the official instructions for manual installation.

Using Wii-Linux

Main article: Using Wii-Linux

Once a Wii has booted Linux, there are lot's of things for users new to Linux to do.

  • A GUI is available, in the form of an X.org server. Although it is not optimized for a "10-foot user interface", like that found in the Wii Menu. A Wii Remote may be used as a pointing device with the X.org server, but manual configuration is needed. (See xwhiite)
  • It's possible for a Wii to powerup directly into Wii-Linux. BootMii must be installed in boot2 for this feature. To enable this, replace the file /bootmii/ppcboot.elf (on the front SD Card) with the GC-Linux kernel of your choice (Remember to back up the original ppcboot.elf somewhere!!)

Hardware Compatibility

Before Wii-Linux supported internal Wi-Fi, users were forced to use USB Ethernet Adapters and USB Wi-Fi dongles for an Internet connection. Supported external hardware is listed.

Note that currently all internal "native" Wii hardware is supported. Some classic hardware (such as GameCube Memory Cards) are still unsupported. A full list of supported hardware is available here.

Also note that NDISwrapper is not available for Wii-Linux since the Nintendo Wii uses a PowerPC-based CPU (NDISwrapper does not have a PPC version and it would take a lot of work to port it)

Troubleshooting

For frequent problems when installing and setting up Wii-Linux

Distributions

Many distributions of GNU/Linux are available for the Nintendo Wii.

Ubuntu 14.04.5

  • Ubuntu PPC for the Wii
  • Designed to be as easy as flash and boot.
  • Made By Wiibuntu
  • TERMINAL ONLY! NO DESKTOP ENVIROMENT!
  • Downloads and .tar's found here.
  • Last updated: 12 March 2024

Ubuntu Server 13.10

  • Ubuntu PPC for the Wii
  • Designed to be as easy as flash and boot.
  • Made By Wiibuntu
  • Downloads found here.
  • Last updated: 11 March 2024

xUbuntu 9.04

  • xUbuntu PPC for the Wii
  • Designed to be as easy as flash and boot.
  • Made By Wiibuntu
  • xorg already installed along with xfce4
  • All repository's are set to old-releases already
  • Downloads and .tar's found here.
  • Last updated: 7 February 2024

Wii-Linux-NGX

  • Based on Debian Jessie 8.0
  • Made by neagix, who keeps the repository for the distribution on github

Includes several different branches of implementations of the GNU/Linux kernel:

Current working features:

  • WiFi
  • Reading DVD-ROMs
  • Xorg (using the framebuffer)

Last Update: 6 September 2017.

Whiite

Whiite-linux is a Debian 5.0 (lenny) based Linux distribution for the Nintendo Wii.

  • Wifi, USB2.0 and DVD drive support when running with MikeP5
  • Easy Wifi configuration tool in /root/ to run type ./whiite-ez-wifi-config
  • Version 1.10 (Debian Lenny 5.0) Download
  • Currently uses kernel 2.6.32
  • Written by the gc-linux team.
  • Last updated: 21 Oct 2009

WiiToo!

WiiToo! is a minimal precompiled stage4 made to let you run Gentoo on your Wii using MIKE and Mini. It provides all the basic software required to compile and install new programs on it, and some other software ready to be used. The kernel used is plain vanilla-sources & Wii-Linux patches, so expect WiFi working out of the box.

  • Ready to use, uncompress, copy, configure and run
  • Highly configurable, like Gentoo
  • USB keyboard isn't a requirement, simply configure your network and use SSH
  • Can use all the hardware that Wii-Linux is able to use
  • Last update: 29 October 2009

Archii

  • 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 X.Org installed along with the OpenBox3 WM and Cwiid for Wii Remote input
    • It also includes the Opera Browser, X-Chat IRC client and Pidgin IM client
    • The Minimal image is just enough to get you booted and the end user can install any packages they wish using pacman
  • File-system tars can be found here.
  • Last updated: 11 July 2009

XWhiite

  • Whiite but with the X.Org environment successfully implemented.
  • It currently uses kernel 2.6.32.
  • It also includes some applications including Firefox.
  • It uses the whiite method of installation
  • It has now been updated to v0.2
  • Made by bertjan
  • v0.2 Download
  • Last updated: 02 December 2008

Wii Linux Continuation Project

External links

  • A video showing Arch Linux on the Wii called, "Archii."
  • A video showing a playable pacman console game with Wii Remote 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