1,386
edits
Changes
Wii U Void Linux Setup Guide (view source)
Revision as of 02:16, 11 February 2023
, 02:16, 11 February 2023no edit summary
==Initial setup==
==Initial setup==
Flashing and configuring the SD card to boot a Linux based operating system is described in this video: [https://www.youtube.com/watch?v=D2S1MHjDCZkWii U Linux Installation Tutorial (Void Linux for Wii U)].
Flashing and configuring the SD card to boot a Linux based operating system is described in this video: [https://www.youtube.com/watch?v=D2S1MHjDCZk Wii U Linux Installation Tutorial (Void Linux for Wii U)].
If your Wii U is already booted in Void, you can continue here.
If your Wii U is already booted in Void, you can continue here.
You should then see a "#" character at the bottom of your screen. Type "bash", and press enter. Now, you can start setitng up your system.
You should then see a "#" character at the bottom of your screen. Type "bash", and press enter. Now, you can start setitng up your system.
==Internet connection==
==Internet connection==
Run the command:
Run the command:
<nowiki>
<nowiki>
date -s YYYY-MM-DD</nowiki>
YYYY-MM-DD should be the current date. For example, if it is August 27, 2021, it would be entered as 2021-08-27.
YYYY-MM-DD should be the current date. For example, if it is August 27, 2021, it would be entered as 2021-08-27.
<nowiki>
<nowiki>
dhcpcd -w</nowiki>
This should automatically set up your network connection. To verify that it worked, run:
This should automatically set up your network connection. To verify that it worked, run:
<nowiki>
<nowiki>
ping voidlinux.org</nowiki>
If the output of this command has lines that start with "64 bytes from", your internet connection is working. If it times out, verify that everything is set up properly and try connecting again using the same dhcpcd command. This command will run forever until you stop it manually by pressing Control+C.
If the output of this command has lines that start with "64 bytes from", your internet connection is working. If it times out, verify that everything is set up properly and try connecting again using the same dhcpcd command. This command will run forever until you stop it manually by pressing Control+C.
<nowiki>
<nowiki>
ln -s /etc/sv/dhcpcd /var/service</nowiki>
Once you have a working network connection, you can begin installing software.
Once you have a working network connection, you can begin installing software.
Before you can begin installing software, you will need to run a couple initial setup commands. Run these in order:
Before you can begin installing software, you will need to run a couple initial setup commands. Run these in order:
SSL_NO_VERIFY_PEER=1 xbps-install -Sy
This will download the list of currently available software packages, and must be ran before you can do anything else since by default there is no list and all packages will fail to install.
(Prepend SSL_NO_VERIFY_PEER=1 to each subsequent xbps command or set it as an environment variable in ~/.bashrc) This will download the list of currently available software packages, and must be ran before you can do anything else since by default there is no list and all packages will fail to install.
<nowiki>
<nowiki>
xbps-install -u -y xbps</nowiki>
This will update the XBPS program, which is the program that handles downloading and managing software packages. This is needed since the version of XBPS included with the current Void Linux image is too old to work properly without being updated.
This will update the XBPS program, which is the program that handles downloading and managing software packages. This is needed since the version of XBPS included with the current Void Linux image is too old to work properly without being updated.
<nowiki>
<nowiki>
xbps-install -S <name of package></nowiki>
You should do xbps-install -Syu to upgrade the whole system before installing any software.
A list of available packages can be found [https://repo.voidlinux-ppc.org/stats.html here]. In this table, if a package is marked with green under the "ppc" column (fourth from the right), it is available for the Wii U. You can use lists like [https://wiki.archlinux.org/title/List_of_applications this one] to find programs to install, although some of the package names may be different on Void.
A list of available packages can be found [https://repo.voidlinux-ppc.org/stats.html here]. In this table, if a package is marked with green under the "ppc" column (fourth from the right), it is available for the Wii U. You can use lists like [https://wiki.archlinux.org/title/List_of_applications this one] to find programs to install, although some of the package names may be different on Void.
To use the entire capacity of your USB drive, you first need to install a program called Parted. Run the following command:
To use the entire capacity of your USB drive, you first need to install a program called Parted. Run the following command:
<nowiki>
<nowiki>
xbps-install -S -y parted wget</nowiki>
The -y option automatically installs the program without requiring any extra input, and the "wget" program is added as it is needed to download a setup script.
The -y option automatically installs the program without requiring any extra input, and the "wget" program is added as it is needed to download a setup script.
Now, run the following:
Now, run the following:
<nowiki>
wget --no-check-certificate <nowiki>https://raregamingdump.ca/files/resize_fs.sh</nowiki>
And then:
And then:
<nowiki>
<nowiki>
chmod +x ./resize_fs.sh</nowiki>
<nowiki>
<nowiki>
./resize_fs.sh</nowiki>
The last command will take a few minutes to complete, and will take longer for larger drives. If it fails with an error, you may have to reflash your USB drive.
The last command will take a few minutes to complete, and will take longer for larger drives. If it fails with an error, you may have to reflash your USB drive.
<nowiki>
<nowiki>
echo 'TIMEZONE="Timezone1/Timezone2"' >> /etc/rc.conf</nowiki>
Replace Timezone1/Timezone2 with the timezone specified by the time zone picker.
Replace Timezone1/Timezone2 with the timezone specified by the time zone picker.
<nowiki>
<nowiki>
xbps-install -S -y chrony</nowiki>
Once it is installed, run this command to enable it:
Once it is installed, run this command to enable it:
<nowiki>
<nowiki>
ln -s /etc/sv/chronyd /var/service</nowiki>
Your system time should now be constantly synchronized and accurate.
Your system time should now be constantly synchronized and accurate.
First, run the following command and follow the instructions on the screen:
First, run the following command and follow the instructions on the screen:
<nowiki>
<nowiki>
passwd root</nowiki>
This will allow you to set a new password for the root account.
This will allow you to set a new password for the root account.
Then, run:
Then, run:
<nowiki>
<nowiki>
useradd username</nowiki>
Replace "username" with the username you want, such as your own name. The username must not have any spaces.
Replace "username" with the username you want, such as your own name. The username must not have any spaces.
To set the password of this new user, run:
To set the password of this new user, run:
<nowiki>
<nowiki>
passwd username</nowiki>
You need to do this before you can log in as this user.
You need to do this before you can log in as this user.
<nowiki>
<nowiki>
xbps-install -S -y xorg xterm</nowiki>
This will install the Xorg display server and the Xterm program, which are needed to use a graphical environment.
This will install the Xorg display server and the Xterm program, which are needed to use a graphical environment.
Here are some application notes and suggestions for the Wii U:
Here are some application notes and suggestions for the Wii U:
*Gecko (Firefox) and Blink (Chromium)-based web browsers will not work, so you are limited to WebKit-based browsers such as Eolie (the "eolie" package). These are very slow (as with everything on Wii U Linux currently), but can browse the modern web and can handle some sites which the Wii U's browser cannot due to its outdated SSL support.
*Gecko (Firefox) and Blink (Chromium)-based web browsers will not work, so you are limited to WebKit-based browsers such as Eolie (the "eolie" package) and "surf" (a very lightweight WebKit browser). These are very slow (as with everything on Wii U Linux currently), but can browse the modern web and can handle some sites which the Wii U's browser cannot due to its outdated SSL support. The "netsurf" browser can also be used, but has limited support for the modern web (although it is much faster than WebKit-based options).
*As the default Xterm terminal emulator is hard to use on a large screen, an alternative terminal emulator such as xfce4-terminal is recommended.
*As the default Xterm terminal emulator is hard to use on a large screen, an alternative terminal emulator such as xfce4-terminal is recommended.