Exploits the Wii U's bluetooth stack to gain IOSU kernel access via bluetooth.
For a more detailed write-up see WRITEUP.md.
Not to be confused with BlueBomb for the Wii and Wii Mini.
- A Wii U which is able to pair a Wii Remote
- A PC with bluetooth
- A PC or VM running a version of Linux which is able to run the custom build of BlueZ
- Run
sudo apt install build-essential libbluetooth-dev libglib2.0-dev libdbus-1-dev git
to install the required dependencies. - Run
git clone https://github.com/rnconrad/WiimoteEmulator && cd WiimoteEmulator
. - Run
source ./build-custom.sh
to build BlueZ.
Don't worry if building the emulator itself fails due to missing SDL headers. Just continue with the next steps. - Stop the already running bluetooth service
sudo systemctl disable --now bluetooth
- Run the custom built bluetoothd
sudo ./bluez-4.101/dist/sbin/bluetoothd -d -n
- Download the
bluubomb
binary and thesd_kernels.zip
from the releases page.
Copy a kernel binary of your choice from thesd_kernels.zip
to the root of your SD Card and rename it tobluu_kern.bin
.
Take a look at Kernel binaries for more information. - Power on the Wii U, insert your SD Card and press the sync button. Make sure there are no other controllers connected.
- Open a new terminal and make the bluubomb file executable by running
chmod +x bluubomb
- Run
sudo ./bluubomb
and wait for the pairing process to complete.
This might take a minute.
If you get a warning about Simple Pairing mode read the Simple Pairing mode section below.
Write down the Wii U's bluetooth device address that's displayed after the pairing is complete.
You can now run sudo ./bluubomb <bdaddr here>
to connect directly to the Wii U and skip the pairing process.
Launches a launch.rpx from the root of your SD card on the next application launch.
Applies IOSU patches to temporarily remove region restrictions.
This should be helpful if you've locked yourself out of your applications due to permanent region modifications.
Launches a wupserver instance directly after using bluubomb.
This gets you full system access remotely via wupclient (replace the IP in line 29 with the one of your Wii U).
This works without having to leave the controller pairing screen.
Installs a valid signed WUP.
To use it copy the WUP to the install
folder on the root of your SD Card, then run bluubomb.
On success the console will reboot, on failure it will power off.
On some devices the simple pairing mode can't be disabled by bluubomb.
You can check the current Simple Pairing mode by running hciconfig hci0 sspmode
.
Make sure it says Simple Pairing mode: Disabled
.
If not run sudo hciconfig hci0 sspmode disabled
and sudo hciconfig hci0 reset
.
Then check the mode again.
To build you need to have gcc and devkitARM installed.
Then run make
.
- GaryOderNichts - bluubomb
- rnconrad for the WiimoteEmulator
- dimok789 and everyone else who made mocha possible