1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
# Setup the Patcher
When you run the patcher, it will make sure you have everything you need before you start, including making sure you have the Riibalanced patch files in the right location. But if you want to be on the safe side before beginning, you can follow this guide.
Click your OS below to jump to their instructions:
* [Linux/BSD](#linuxbsd)
* [macOS](#macOS)
Windows users can choose one of the two options below for setting up the script:
* [WSL](#windows---wsl) (**RECOMMENDED**, a little tricky to install but easy to remove)
* [Cygwin](#windows---cygwin) (More advanced, simple to install but difficult to remove)
## Linux/BSD
Simply install `git`, `curl`, and `bash` (which is most likely installed) with your distro's package manager, then clone the repository and run the script:
```bash
git clone https://github.com/brysonsteck/riibalanced-patcher.git
cd riibalanced-patcher
./patch_iso.sh
```
## macOS
Make sure the Xcode Developer Tools are installed by running the following command in Terminal. If they are not installed, a window will appear asking if you want to install them:
```
xcode-select --install
```
Then simply clone the repository and run the script in Terminal. It does not matter if your default shell is `zsh`; macOS will notice to run `bash` on the script:
```bash
git clone https://github.com/brysonsteck/riibalanced-patcher.git
cd riibalanced-patcher
./patch_iso.sh
```
## Windows - WSL
**This is the RECOMMENDED way to use the patcher on Windows.**
### Installing WSL
You can skip to [Running the patcher on WSL](#Running-the-patcher-on-wsl) if you already have a WSL distro installed. You can alternatively use [Microsoft's documentation](https://docs.microsoft.com/en-us/windows/wsl/install) as a guide to install WSL.
To install WSL, you need to have Windows 10 with build 19041 or higher, or Windows 11. To check your Windows 10 build, run `winver` in Command Prompt. If you cannot/refuse to update to such versions, you can try using the [Cygwin](#windows---cygwin) method to run the patcher.
Open a Command Prompt as Administrator and type:
```
wsl --install -d Debian
```
This will install WSL and the other necessary software before prompting you to reboot. WSL is basically a Linux virtual machine baked into Windows.
Upon reboot, Windows should automatically continue the installation after logging in. If it does not, you may have to nudge it by typing `wsl` in Command Prompt and hitting ENTER. After it does install, it will ask you for a UNIX username and password. These two things do not have to be the same as your Windows login, but remember your password as it is necessary to install software in the WSL machine. Upon completing your user setup, run the following:
```
sudo apt update && sudo apt upgrade
```
Your "sudo password" is the password you used to create your UNIX account. Upon running this command, move forward to the next section.
### Running the patcher on WSL
Install `git`, `curl`, and `bash` with your distro's package manager. If you installed WSL using my guide above, you would simply type the command below to do so (`bash` is already installed):
```
sudo apt install git curl
```
Once the install is complete, you can clone the repository and run the script:
```bash
git clone https://github.com/brysonsteck/riibalanced-patcher.git
cd riibalanced-patcher
./patch_iso.sh
```
Transferring files between WSL and Windows can be done by copying files to the desired directory within the Linux section in the sidebar of File Explorer (in Windows 11 and in more recent builds of Windows 10) or navigating to the `/mnt/c` directory within WSL and using `cp` or `mv`.
### Uninstalling WSL
If you only wanted to run this patcher once, you can simply uninstall it by running the following in Command Prompt:
```
wsl --unregister Debian
```
## Windows - Cygwin
These instructions are accurate as of setup version 2.918. **Use the [WSL guide](#windows---wsl) if you plan on uninstalling the software after using the patcher, as it is easier to uninstall.** **Do not follow these instructions if you have already installed a WSL distro.**
### Installing Cygwin
You can skip to [Running the patcher on Cygwin](#Running-the-patcher-on-Cygwin) if you already have Cygwin installed.
To install Cygwin, you need to [download the installer]() from the Cygwin website. Upon downloading, run the program as Administrator.
When it asks to choose a download source, choose "Install from Internet" and click "Next".
You can change the install direcotry if you wish, including installing for all users or just yourself.
You can leave alone where it asks to select the local package directory, this is a temporary folder during installation.
Setup the proxy if your internet requires.
You will then be asked for the mirror/"download site". You can usually chose the top-most item on the list and be fine.
A window will appear asking what software you want installed. Use the search bar or browse the submenus for an item called `git` and install it by selecting it in the submenu on the right of the table entry, then you can click "Next" leaving everything defaulted. This may take a few minutes depending on your disk speed and internet connection.
Once everything has downloaded, you can add shortcuts on the desktop or Start Menu if you wish before clicking "Finish".
### Running the patcher on Cygwin
If you have installed Cygwin already (i.e. not by using my guide above), make sure that `git` and `curl` is installed.
Start Cygwin by using the shortcut(s) you made or by running the batch file where you installed it (probably `C:\cygwin64`), then you can clone the repository and run the script:
```bash
git clone https://github.com/brysonsteck/riibalanced-patcher.git
cd riibalanced-patcher
./patch_iso.sh
```
Transferring files between Cygwin and Windows can be done by copying files to the desired directory within the Cygwin install (probably `C:\cygwin64`) using File Explorer, or navigating to the `/cygdrive/c` directory within Cygwin and using `cp` or `mv`.
### Uninstalling Cygwin
If you only wanted to run this patcher once, you may be stuck with Cygwin unless you want to go through a tedious removal process. Cygwin unfortunately does not come with an uninstaller and cannot be uninstalled through Control Panel or Windows Settings. You can follow the official FAQ guide on the [Cygwin website](https://www.cygwin.com/faq.html#faq.setup.uninstall-all) to uninstall it completely.
|
