Skip to content

Commit 01329c0

Browse files
committed
Initial markdown review, add markdownlint.json
1 parent 9d74dbd commit 01329c0

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+616
-539
lines changed

.gitignore

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,4 +8,4 @@ docs/.vitepress/cache
88
docs/.vitepress/dist
99

1010
# macOS
11-
.DS_Store
11+
.DS_Store

.markdownlint.json

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
{
2+
"MD003": { "style": "atx" },
3+
"MD004": { "style": "asterisk"},
4+
"MD007": { "indent": 4 },
5+
"MD013": false,
6+
"MD024": { "siblings_only": true },
7+
"MD029": { "style": "one" },
8+
"MD033": { "allowed_elements": ["br"], "table_allowed_elements": ["hr", "br", "ul", "li"]},
9+
"MD035": { "style": "---" },
10+
"MD040": false,
11+
"MD045": false,
12+
"MD046": { "style": "fenced" },
13+
"MD048": { "style": "backtick" },
14+
"MD049": { "style": "asterisk" },
15+
"MD050": { "style": "asterisk" },
16+
"MD055": { "style": "leading_and_trailing" },
17+
"MD060": { "style": "aligned" }
18+
}

docs/bluebomb.md

Lines changed: 25 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -48,12 +48,14 @@ Make sure that the console is close to the computer running the exploit, ideally
4848
* A Virtual Machine may work, but it is not recommended due to its complexity in getting Bluetooth passthrough working. If possible, please use a LiveUSB as described below.
4949
* If you have a Raspberry Pi, you can use that instead as it most likely has Linux installed already.
5050
* ARM64 Raspberry Pi's need multiarch enabled with the armhf (32bit) architecture added. The following should work on any debian based OS:
51+
5152
```bash
5253
sudo sudo dpkg --add-architecture armhf
5354
sudo apt update && sudo apt install -y screen:armhf
5455
file /usr/bin/screen # should say ELF 32-bit
5556
screen
5657
```
58+
5759
* Windows Subsystem for Linux or a Chromebook running Linux mode will *not work* as they don't have direct access to the Bluetooth adapter or USB ports.
5860
* If you do not have Linux, [Ubuntu](https://ubuntu.com/download/desktop) is the most user-friendly option and can be ran on computers running Windows or intel based Macs.
5961
* Apple Silicon Macs will not work due to them missing the ARM32 instructions in the hardware.
@@ -64,24 +66,24 @@ Make sure that the console is close to the computer running the exploit, ideally
6466
* An internal Bluetooth adapter will work.
6567
* If you do not have one, make sure to get one compatible with Linux.
6668
* A USB flash drive [formatted to FAT32/MS-DOS](https://wiki.hacks.guide/wiki/Formatting_an_SD_card)
67-
* This cannot be the same flash drive used for your Linux Machine.
69+
* This cannot be the same flash drive used for your Linux Machine.
6870
* [HackMii Installer v1.2](https://bootmii.org/download/)
6971
7072
### Instructions
7173
72-
1. Copy `boot.elf` from the hackmii_installer_v1.2 `.zip` to the root of your flash drive.
73-
+ (If attempting to fix a brick, you should also copy the homebrew app you wish to use to /apps/)
74-
+ (Even for a Wii mini, bootmini.elf will **not** work, its purpose is entirely different and unrelated. Use boot.elf in all cases).
74+
1. Copy `boot.elf` from the hackmii_installer_v1.2 `.zip` to the root of your flash drive.
75+
* (If attempting to fix a brick, you should also copy the homebrew app you wish to use to /apps/)
76+
* (Even for a Wii mini, bootmini.elf will **not** work, its purpose is entirely different and unrelated. Use boot.elf in all cases).
7577
7678
![](/images/exploits/bluebomb/usb-exploit.png)
7779
7880
1. Reinsert your flash drive into your console.
79-
+ For a Wii mini, the USB port is on the back.
80-
+ For a normal Wii, use the bottom port (or the right port if it's upright).
81+
* For a Wii mini, the USB port is on the back.
82+
* For a normal Wii, use the bottom port (or the right port if it's upright).
8183
1. Power on your console.
8284
1. Go to `Wii Settings`.
8385
1. Take note in the top right corner of the letter next to the system version.
84-
+ This letter corresponds to your system menu region, which you will need to know for the corresponding steps.
86+
* This letter corresponds to your system menu region, which you will need to know for the corresponding steps.
8587

8688
![](/images/wii/SystemMenuVersion.png)
8789

@@ -101,24 +103,24 @@ Make sure that the console is close to the computer running the exploit, ideally
101103

102104
![](/images/exploits/bluebomb/console-type.png)
103105

104-
+ If you have selected a Wii mini you will be asked to provide your region. This can be determined by the last letter of the Wii Menu version (`U` for **USA** and `E` for **PAL** models).
106+
* If you have selected a Wii mini you will be asked to provide your region. This can be determined by the last letter of the Wii Menu version (`U` for **USA** and `E` for **PAL** models).
105107

106108
![](/images/exploits/bluebomb/wii-mini-options.png)
107109

108-
+ If you have selected a Wii you will be asked to provide your Wii Menu version (what you determined in step 4).
110+
* If you have selected a Wii you will be asked to provide your Wii Menu version (what you determined in step 4).
109111

110112
![](/images/exploits/bluebomb/wii-options.png)
111113

112114
1. Power on your console.
113-
+ **Do not** connect any Wii Remotes.
115+
* **Do not** connect any Wii Remotes.
114116
1. Type `yes` in the script to proceed if you have not already done so, and make sure that `Waiting to accept` is displaying.
115117
1. Press the Sync button repeatedly until the terminal shows `got connection handle`.
116-
+ This could take numerous attempts.
118+
* This could take numerous attempts.
117119

118120
![](/images/exploits/bluebomb/got-connection-handle.png)
119121

120122
1. If the exploit was successful, you should see a similar screen to the below, after which the HackMii installer should load.
121-
+ If you are not planning to use it later, you can now shut down your Linux distro.
123+
* If you are not planning to use it later, you can now shut down your Linux distro.
122124

123125
![](/images/exploits/bluebomb/thanks-fullmetal5.png)
124126

@@ -166,6 +168,7 @@ Make sure that the microcontroller is close to the computer running the exploit,
166168
:::
167169

168170
### Requirements
171+
169172
* A Raspberry Pi Pico W 1/2 or an ESP32 with BR/EDR (Classic) support.
170173
* A USB flash drive [formatted to FAT32/MS-DOS](https://wiki.hacks.guide/wiki/Formatting_an_SD_card)
171174
* [The HackMii Installer](https://bootmii.org/download/)
@@ -178,19 +181,19 @@ A normal Raspberry Pi Pico will not work. It MUST be the wireless model. Additio
178181

179182
### Instructions
180183

181-
1. Copy `boot.elf` from the hackmii_installer_v1.2 `.zip` to the root of your flash drive.
182-
+ (If attempting to fix a brick, you should also copy the homebrew app you wish to use to /apps/)
183-
+ (Even for a Wii mini, bootmini.elf will **not** work, its purpose is entirely different and unrelated. Use boot.elf in all cases).
184+
1. Copy `boot.elf` from the hackmii_installer_v1.2 `.zip` to the root of your flash drive.
185+
* (If attempting to fix a brick, you should also copy the homebrew app you wish to use to /apps/)
186+
* (Even for a Wii mini, bootmini.elf will **not** work, its purpose is entirely different and unrelated. Use boot.elf in all cases).
184187

185188
![](/images/exploits/bluebomb/usb-exploit.png)
186189

187190
1. Reinsert your flash drive into your console.
188-
+ For a Wii mini, the USB port is on the back.
189-
+ For a normal Wii, use the bottom port (or the right port if it's upright).
191+
* For a Wii mini, the USB port is on the back.
192+
* For a normal Wii, use the bottom port (or the right port if it's upright).
190193
1. Power on your console.
191194
1. Go to `Wii Settings`.
192195
1. Take note in the top right corner of the letter next to the system version.
193-
+ This letter corresponds to your system menu region, which you will need to know for the corresponding steps.
196+
* This letter corresponds to your system menu region, which you will need to know for the corresponding steps.
194197
195198
![](/images/wii/SystemMenuVersion.png)
196199
@@ -199,7 +202,7 @@ A normal Raspberry Pi Pico will not work. It MUST be the wireless model. Additio
199202
#### Raspberry Pi Pico W
200203
201204
1. Download the latest [Pre-Compiled Binaries](https://github.com/GaryOderNichts/bluebomb_micro/releases) from the releases page, and extract it to your PC.
202-
+ Select the appropriate binaries for your device. `bluebomb_micro_pico2_w_version` is for the Pico 2 W, while `bluebomb_micro_pico_w_version` is for the Pico 1 W.
205+
* Select the appropriate binaries for your device. `bluebomb_micro_pico2_w_version` is for the Pico 2 W, while `bluebomb_micro_pico_w_version` is for the Pico 1 W.
203206
204207
![](/images/exploits/bluebomb/pico-download.png)
205208
@@ -209,7 +212,7 @@ A normal Raspberry Pi Pico will not work. It MUST be the wireless model. Additio
209212
![](/images/exploits/bluebomb/pico-drive.png)
210213
211214
1. Unzip the downloaded archive and copy the file which matches your Wii or Wii mini to the drive.
212-
+ If you have a European Wii running version 4.3, you would copy bluebomb_WII_SM4_3E.uf2, or if you have a European Wii Mini, you would copy bluebomb_MINI_SM_PAL.uf2, etc...
215+
* If you have a European Wii running version 4.3, you would copy bluebomb_WII_SM4_3E.uf2, or if you have a European Wii Mini, you would copy bluebomb_MINI_SM_PAL.uf2, etc...
213216
214217
![](/images/exploits/bluebomb/pico-files.png)
215218
@@ -228,9 +231,9 @@ A normal Raspberry Pi Pico will not work. It MUST be the wireless model. Additio
228231
229232
1. Plug your flashed device back into your PC.
230233
1. Power on your console.
231-
+ **Do not** connect any Wii Remotes.
234+
* **Do not** connect any Wii Remotes.
232235
1. Press the Sync button repeatedly until the Pico W LED begins to rapidly flash, at which point it will start uploading the exploit.
233-
+ This could take numerous attempts.
236+
* This could take numerous attempts.
234237
1. If the exploit was successful, you should see a similar screen to the below, after which the HackMii installer should load.
235238
236239
![](/images/exploits/bluebomb/thanks-fullmetal5.png)

docs/bootmii.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ If you have BootMii installed as boot2, you will need to launch BootMii by resta
2929

3030
::: warning
3131

32-
If the `Launch BootMii` button does not appear in the Homebrew Channel, [re-launch the HackMii Installer](hackmii) and install BootMii.
32+
If the `Launch BootMii` button does not appear in the Homebrew Channel, [re-launch the HackMii Installer](hackmii) and install BootMii.
3333

3434
:::
3535

@@ -60,12 +60,12 @@ If you have BootMii installed as boot2, you will need to launch BootMii by resta
6060
![](/images/bootmii/BootMii_Backup.png)
6161

6262
1. A NAND backup will start. You can watch the progress on the screen.
63-
+ "Bad Blocks" are normal, and mostly originate from the factory due to NAND binning. Don't worry when you see some on a NAND backup.
63+
* "Bad Blocks" are normal, and mostly originate from the factory due to NAND binning. Don't worry when you see some on a NAND backup.
6464

6565
![](/images/bootmii/BootMii_NAND_Backup.png)
6666

6767
1. After the previous step completes, BootMii will verify the backup. Ideally, all the blocks should be green after the verification process.
68-
+ If you have factory bad blocks with uncorrectable pages, these blocks may fail to verify. As long as all non-bad blocks are successfully verified, this should be fine.
68+
* If you have factory bad blocks with uncorrectable pages, these blocks may fail to verify. As long as all non-bad blocks are successfully verified, this should be fine.
6969

7070
![](/images/bootmii/BootMii_NAND_Backup_Verify.png)
7171

docs/bootmiirecover.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# BootMii Recovery
22

3-
This guide will provide instructions on how to restore a backup of your NAND with BootMii. Please bear in mind that this is usually the <strong>last resort</strong> method of repairing a brick if you have one, and if it does not fix your issue, you may have to seek support. If you are still able to enter BootMii, make an attempt to enter the Homebrew Channel instead so that you may attempt to [identify and repair the brick](bricks) using other methods.
3+
This guide will provide instructions on how to restore a backup of your NAND with BootMii. Please bear in mind that this is usually the **last resort** method of repairing a brick if you have one, and if it does not fix your issue, you may have to seek support. If you are still able to enter BootMii, make an attempt to enter the Homebrew Channel instead so that you may attempt to [identify and repair the brick](bricks) using other methods.
44

55
::: info
66

@@ -40,17 +40,17 @@ If you want to restore a game's save data, use Dolphin to import your NAND backu
4040

4141
## Important preliminary notes
4242

43-
+ If you have not done anything to cause a brick (or you're starting up your Wii after a long time), then it is probably a [Wi-Fi Brick](bricks#wi-fi-brick).
43+
* If you have not done anything to cause a brick (or you're starting up your Wii after a long time), then it is probably a [Wi-Fi Brick](bricks#wi-fi-brick).
4444

45-
+ If you have BootMii as IOS installed, RestoreMii will prompt you for the Konami code via a GameCube Controller.
45+
* If you have BootMii as IOS installed, RestoreMii will prompt you for the Konami code via a GameCube Controller.
4646

47-
+ You must use the POWER (right) and RESET (select) buttons on your console, or a GameCube controller plugged into port 1 to navigate BootMii. To navigate with a GameCube controller, click left/right on the +Control Pad on a GameCube controller. To select, press A.
47+
* You must use the POWER (right) and RESET (select) buttons on your console, or a GameCube controller plugged into port 1 to navigate BootMii. To navigate with a GameCube controller, click left/right on the +Control Pad on a GameCube controller. To select, press A.
4848

4949
## Instructions
5050

5151
1. Launch the Homebrew Channel.
5252
1. Press the HOME Button, then select "Launch BootMii".
53-
+ If the Homebrew Channel is inaccessible and you have Priiloader installed, you may also access it on boot and select `BootMii IOS` to load BootMii.
53+
* If the Homebrew Channel is inaccessible and you have Priiloader installed, you may also access it on boot and select `BootMii IOS` to load BootMii.
5454

5555
![](/images/bootmii/BootMii_HBC.png)
5656

0 commit comments

Comments
 (0)