Getting a GUI working on wiiu-linux!
Requisites
- An hacked Wii U, use Haxchi or CBHC, Mocha (idk i havent tested it) or just a way to boot the homebrew channel (actually you dont need to modify your console, just don't expect me to cover how to install the homebrew channel on the sd),
- A working SD card with working wiiu-linux
- One of these three things:
- A lan to usb adapter (WARNING: not all of them are compatible with the wiiu!),
- An android or iPhone with a usb cable to be used with usb tethering,
- A bluetooth compatible phone to use bluetooth tethering (WARNING: using bluetooth with wiiu linux is an hassle, so i will not guide you through this step),
- A usb keyboard (preferibly wireless),
- A usb mouse (preferibly wireless),
- A usb hub (as the lan to usb adapter, not all are compatible, but you should be still that lucky to have one compatible),
- A usb to use as RootFS (at least 2-4 gb) (follow the steps above);
If you have all of the things listed above, you are ready to go!
Preparing all
Extract this on the root of your sd card: (http://www.mediafire.com/file/owren7g08090ke4/LinuxPackage.rar) and follow this (taken directly from the original wiiu-linux readme):
While we started off developing with Gentoo, we swapped to Debian unstable (everything's precompiled) so that's what we recommend you do too. Debain stable/testing is unbearably outdated on PowerPC so yes, you should use sid/unstable. To make a system, you can use debootstrap or our prebuilt option:
1. Be on Linux. Get a USB (512mb bare minimum) and format it with a single ext4 partition. This will be your rootfs, so make sure it's a decent quality one (speed is important)
2. Download (https://mega.nz/#!la52GDSS!Y9TnuFmvbWRbFZww7LPvVsyh2egz4CTDyxC2R5r62r4), we'll call it "debian.tar.xz"
3. Mount and cd into your new USB.
4. Run `tar -xvpf <path/to/debian.tar.xz>`. The p is important, you could skip the v.
5. Eject the drive and plug it into your Wii U. With any luck, it'll boot Debian! Log in with username root and password root.
For Windows users, we've created an image as of 2018-02-28 that you can load with Win32DiskImager (or equivalent). For now, it's a fixed 2 GB image, but partition resizing might be implemented eventually. Instructions:
1. Grab a USB (2 GB minimum) and plug it in. Note the drive letter; you'll need this in step 3.
2. Download [this](https://mega.nz/#!PvhwlaYT!iVGqf7W7dm4XATwJFiCeTzgvaPXBhVLIhzuiUjPF6JQ) disk image and a copy of [Win32DiskImager](https://sourceforge.net/projects/win32diskimager/files/).
3. In Win32DiskImager, load the disk image, select the drive letter of your USB, and click Write. **Be very careful to pick the right drive letter; you don't want to write to your main hard disk!**
4. After Win32DiskImager finishes writing, eject the drive and plug it into your Wii U. With any luck, it'll boot Debian! Log in with username root and password root.
(This comes with a small bonus: you can also use Win32DiskImager to back up your root filesystem by reading the drive to a new file.)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
After all of this you should be ready to start the fun!
The hard part
Now now now, are you ready to start having fun with wiiu-linux? If yes, go on!
Plug your sd inside your Wii U, detach every single hdd or usb drives plugged in and plug the usb hub. On the hub plug the usb keyboard, the usb mouse, the usb cable for your phone (or for the lan adapter) and the RootFS USB.
Once you did all of this, read through this:
CBHC Users: when cbhc shows "Autobooting..." spam the home button until a menu pops out and from there select "Homebrew channel";
Haxchi Users: it's really hard to say which button prompts you on the hb channel becuase of various config files, but you should try to hold A the first time: basically you start Haxhi and immediately after hold A until it boots to the hb channel. If it doesn't, just try to hold other buttons;
Mocha Users: just use the browser exploit to enter the hb channel;
Now that you are in, you have to start the app called CFW Booter and wait for it to load the wiiu linux (actually, you need to have the tv monitor on and also, if it says something about errors and rebooting in 180 seconds, something went wrong and you should repeat the usb flash steps until you get it working).
If all went good you should see a screen prompting you for username and password, put for both "root".
From now the "hard" part comes:
Type on the console nano /etc/apt/sources.list and wait for a screen to appear;
Now that you are inside nano (a console text editor) delete everything this files contains and put this strings inside the file:
Code:deb http://ftp.debian.org/debian/ sid main deb-src http://ftp.debian.org/debian/ sid main
After you wrote everything in order click Control-O, enter and Control-X. You should now be out of nano;
From now there are three ways:
- LAN to USB Users: if you already connected the adapter and the lan cable to the usb hub ports, you should be fine, eitherway do it right now;
- Phone with USB Tethering Users:
- Iphone: connect the phone to the usb hub with a usb cable, then go to Settings > Personal hotspot and activate hotspot. You should now type dhclient usb0 and wait for it to go all good "you should see no logs of any kind";
- Android: still connect the phone to the wii u with a usb cable, now go to Settings and you can or search for hotspot on the settings app and enable usb tethering from there, or you should go under the Wifi and connections tab and go to Other > Mobile Tethering/hotspot and from there you should see the option for usb tethering: check it. If you still are unable to enable usb tethering, try to google how to enable usb tethering on your phone. If you activated the option with success, type dhclient usb0 and you should be good!
- Bluetooth Users: no way known to me, if you know how tell me;
From there you will start to download packages that are like of 100 mbs, so you should remember that you are still using your data connection and your operator should charge you for that: i will not be held in any way responsible of any extra money you get charged because you downloaded these packages.
Now if you were able to start internet in any of the previously described ways, then you should run apt update for updating the repositories, then install X.Org by typing apt install xorg and prompt "Y" to start downloading and installing:
this should take up to 20 minutes depending on the speed of your usb and the speed of your connection and just follow the onscreen instructions when prompted.
If xorg was able to install successfully you will have now to type these commands like the first one and then the other one (DON'T REBOOT OR YOU WILL HAVE TO FLASH THE USB AND RESTART FROM THE BEGINNING!!):
Code:sudo systemctl enable multi-user.target --force sudo systemctl set-default multi-user.target
You are now able to choose which desktop enviroment to install (i install every package with the --no-install-recommends option to avoid to download 1gb packages but feel free to do as you want):
XFCE4: type apt --no-install-recommends install xfce4 and as xorg prompt Y (only if you are ok for the package size tho). Wait until the process finishes and then go ahead for the next steps;
LXQt: type apt --no-install-recommends install lxqt and prompt Y to install the package. When the process finishes, go over the next step;
LXDE: i haven't tested lxde, but the procedure should be the same, but for who wants to test here you go: apt --no-install-recommends install lxde, prompt for confirmation and wait for the process to finish to go ahead to the next step;
After you installed one of the above desktop enviroments you are ready to start the x server by just typing startx.
For browsing you need to install firefox via apt (apt install firefox)
LXQt seemed to refuse to open any application other than xterm so i don't actually recommend it unless you want to try something
All the above DE are really slow because of the absence of a concrete GPU driver (as of now rendering is via software)
What else to say? Ah yes, enjoy linux!
Credits
QuarkTheAwesome and CompuCat for making wiiu-linux, a powerful way to run linux even if as of now with some limitations;
GBATemp community for supporting me everytime (not all the community is toxic);
Google for being such a great source of informations!
Loller06 out
Thanks for the tuto
@pwsincd could you put this tuto at the first page ?
Sorry to ask but is someone still working on the GPU part to make it faster ? I don't see improvement about that on the github. It's only to know and not to make pressure on the devs.