Hacks Guide Wiki - User contributions [en]

Wii:Nintendont

2026-05-28T01:29:18Z

MPGIII:

{{Infobox homebrew
| developers = FIX94
| forwii = 1
| image = Nintendont-icon.png
| imagealt = Nintendont Logo
| imagesize = 256px
| version = 4.431+
| releasedate = 2016-12-18
| website = https://oscwii.org/library/app/nintendont oscwii.org/library/app/nintendont
| github = FIX94/Nintendont
}}
Nintendont is a Wii-mode homebrew application that can be used to play GameCube games, as well as Triforce arcade dumps. Nintendont is an interesting app in that it is like a hybrid between an emulator and a virtual machine - while still running GameCube games near exactly at native quality and performance. Further info can be read [https://gbatemp.net/threads/nintendont.349258/ here].

{{info|text=To play games, you are advised to use a large SD card or an external hard drive, flash drives are very sporadic in functionality. See [https://wii.hacks.guide/faq#storage-device-faq storage FAQ].}}

{{info|text=Make sure your storage device is formatted as FAT32. Do not format it to other file systems like NTFS, exFAT, or WBFS.}}

__TOC__

=== Requirements ===
* A modded Wii
* An SD card or USB device
* [https://oscwii.org/library/app/Nintendont Nintendont]

=== Installation ===
# Download Nintendont and extract it to the root of your SD card or USB drive
# Insert your SD card or USB device into your Wii, and launch Nintendont from the Homebrew Channel

=== Quick Start Guide ===
==== Key Features ====
* You can use various input devices to play GameCube games. These include GameCube controllers (even via a USB adapter), Wii Remote + Nunchuk, Classic Controllers, Wii U Pro Controllers, DK Bongos, USB HID controllers, and potentially more. Game Boy Advance consoles are supported on backward compatible systems if native control is enabled.
* Games can be forced to progressive and widescreen output, similar to Dolphin's widescreen hack.
* Nintendont has support for virtual memory cards that are saved to an external storage device, from sizes of 51 blocks up to 1019 blocks. Despite this, the recommended max size is 251 blocks per virtual card for maximum compatibility.
* Backward compatible systems can use retail game discs and/or real memory cards alongside emulated controllers, broadband adapter, memory cards, etc.
* Broadband adapter and ASCII Keyboard Controller emulation with standard USB ethernet/wifi and USB keyboards. These can be used with custom server patches for online multiplayer in certain games. Ethernet is recommended for LAN multiplayer.
* Nintendont can be leveraged in either [https://wii.hacks.guide/usb-loaders#wiiflow-lite WiiFlow Lite] or [https://wii.hacks.guide/wii-loaders#usb-loader-gx USB Loader GX] for the loading of GameCube games.
* Triforce arcade games are supported. Mario Kart Arcade GP Mario Cards and F-Zero AX License Cards can be emulated. Mounting GameCube memory cards in F-Zero AX is not supported. LAN machine linking is not supported. Internal memory is not emulated, so high scores will not save.

==== User Interface ====
[[File:Nintendont-UI-082423.png|763x763px]]

Nintendont uses a user interface that is mainly controllable and navigable using a controller.

==== Properly Launching Games ====
Games in Nintendont have to be launched from an external device with a specific folder structure. USB storage and SD cards are supported, but USB is recommended for faster speeds.

Single-disc games can simply be placed inside the games folder:

* <code>device:/games/(game name).iso</code>

The expected structure for multi-disc games is as follows:

* <code>device:/games/(game name)/game.iso</code>
* <code>device:/games/(game name)/disc2.iso</code> (so on and so forth)

Here is an example using The Legend of Zelda: The Wind Waker on a USB hard drive:
* <code>USB:/games/The Legend of Zelda: The Wind Waker [GZLE01].iso</code>

For the game to be picked up by USB Loader GX, you will need to have each game in its own folder along with its game ID.
Using Wind Waker as the same example, the expected layout would be:
* <code>USB:/games/The Legend of Zelda: The Wind Waker [GZLE01]/game.iso</code>

==== BIOS Setup ====
You can use an original GameCube BIOS in Nintendont if you have legally obtained one.

# Rename the BIOS file <code>iplusa.bin</code>/<code>ipljap.bin</code>/<code>iplpal.bin</code> based on its region.
# Copy it to the root of the storage device that contains your GameCube games.
# Go into Nintendont settings and verify that `Skip IPL` is turned OFF.

Triforce BIOS is also supported and must be extracted from the appropriate game discs. Different versions can be found depending on the game:

* 2.15.0 (SHA1: a2306142ad992ec204e896c65513819536c5bcf8) from the first Triforce Firmware Update Disc (GDT-0011)
* 2.17.0 (SHA1: a3eabb012db09092300e796f5e2239973ce7b978) from Virtua Striker 4 (GDT-0013 and GDT-0015)
* 3.01.2 (SHA1: 61aa40edbd179fe295850946639e2a4b33636b58) from Virtua Striker Ver. 2006 (GDT-0020 and GDT-0021)
* 3.11.2 (SHA1: 418411ee45a96d2ce585c3940a37608c491142ce) from the second Triforce Firmware Update Disc (GDT-0022), also sometimes labeled Triforce Firmware Update For Compact Flash Box (4.01)

Extracting the file differs per game, but you will need a program like GCRebuilder to extract the file from the game disc.

For the first Triforce Firmware Update Disc, extract the file <code>segaboot.img01</code> and delete the first 1048576 bytes in a hex editor so the file starts with the string <code>GCAM</code>.

For Virtua Striker games, extract <code>firm/segaboot.img1</code>.

For the second Triforce Firmware Update Disc, extract <code>segaboot.img1</code>.

Once you have this file, place it in the appropriate path:

# Rename the BIOS file to <code>segaboot.bin</code>.
# Copy it to the root of the storage device that contains your Triforce games.
# Go into Nintendont settings and verify that `Skip IPL` is turned OFF.

=== Memory Cards ===
By default, games will be given their own memory cards in the <code>saves</code> folder on the storage device Nintendont is installed on. If the Memcard Multi option is enabled, every NTSC/PAL game will share one memory card named <code>ninmem.raw</code> while NTSC-J games save to <code>ninmemj.raw</code>. A second memory card can be mounted if another valid memory card file is present and appropriately named. This second card must be named <code>(game id)_b.raw</code>, <code>ninmemb.raw</code>, or <code>ninmemjb.raw</code> depending on which first-slot card would be read. If both cards combined would be above 16 megabytes, the slot B card will not be loaded.
Saves can be extracted, injected, or otherwise managed in the Dolphin Emulator's memory card manager.

==== Using a HID USB controller with Nintendont ====
By default, Nintendont selects a controller configuration from an internal list of already mapped controllers. If yours does not automatically work, make sure to check the supported controller list in the article at the top of the page. If you still want to check anyway, you can use [https://oscwii.org/library/app/HIDTest HIDTest] to determine whether or not your controller will be detected and work with Nintendont.

==== Button combinations for Nintendont in-game ====
Restart: Resets the game and returns to game's title screen.

Shutdown: Exits Nintendont and returns to the loader.

Some games may have native button combinations to reset.

'''GameCube Controller:'''
* Restart: R+Z+Start
* Shutdown: R+Z+B+Down (D-pad)

'''Wiimote + Nunchuck or Classic Controller:'''
* Shutdown: HOME button

'''USB HID controller or adapter:'''

You can define the Shutdown button's combination yourself.

The Power button is defined in the controller.ini or in the correct controllers/PID_VID.ini file used by your gamepad.

Most commonly used combo with default HID settings:

* Shutdown: L+R+Z+Start

Pressing Select on any controller will rotate the face buttons' inputs clockwise for that controller.

== See also ==
* [[gbatempwiki:Nintendont Compatibility List|Nintendont compatibility list on GBAtemp wiki]]

Wii:FriishProduce

2025-01-26T23:24:46Z

MPGIII: Remove notice that app is Windows-only

{{Infobox homebrew
| image = FriishProduce.png
| imagealt = Logo of FriishProduce
| imagesize = 256px
| for3ds = 0
| forwiiu = 0
| forswitch = 0
| forwii = 0
| developers = CatmanFan
| website = https://catmanfan.github.io/FriishProduce https://catmanfan.github.io/FriishProduce
| forwindows = 1
| formac = 0
| forlinux = 0
| forjava = 0
| github = CatmanFan/FriishProduce
}}

FriishProduce is a Wii/vWii channel injector/creator GUI. It can be used to create installable WADs for older consoles, including for Virtual Console (VC) games, as well as for other platforms such as Adobe Flash and RPG Maker 2000/2003.

A tutorial for using FriishProduce can be found [https://catmanfan.github.io/FriishProduce/tutorial on the developer's website].

Wii:FriishProduce

2025-01-26T21:34:40Z

MPGIII: "For Wii" not applicable, "For Windows" is, as this app runs on Windows

{{Infobox homebrew
| image = FriishProduce.png
| imagealt = Logo of FriishProduce
| imagesize = 256px
| for3ds = 0
| forwiiu = 0
| forswitch = 0
| forwii = 0
| developers = CatmanFan
| website = https://catmanfan.github.io/FriishProduce https://catmanfan.github.io/FriishProduce
| forwindows = 1
| formac = 0
| forlinux = 0
| forjava = 0
| github = CatmanFan/FriishProduce
}}

FriishProduce is a Wii/vWii channel injector/creator GUI. It can be used to create installable WADs for older consoles, including for Virtual Console (VC) games, as well as for other platforms such as Adobe Flash and RPG Maker 2000/2003.

{{info|text=FriishProduce is a Windows-only program.}}

A tutorial for using FriishProduce can be found [https://catmanfan.github.io/FriishProduce/tutorial on the developer's website].

Wii:FriishProduce

2025-01-26T21:20:30Z

MPGIII: Fix link formatting

{{Infobox homebrew
| image = FriishProduce.png
| imagealt = Logo of FriishProduce
| imagesize = 256px
| for3ds = 0
| forwiiu = 0
| forswitch = 0
| forwii = 1
| developers = CatmanFan
| website = https://catmanfan.github.io/FriishProduce https://catmanfan.github.io/FriishProduce
| forwindows = 0
| formac = 0
| forlinux = 0
| forjava = 0
| github = CatmanFan/FriishProduce}}

FriishProduce is a Wii/vWii channel injector/creator GUI. It can be used to create installable WADs for older consoles, including for Virtual Console (VC) games, as well as for other platforms such as Adobe Flash and RPG Maker 2000/2003.

{{info|text=FriishProduce is a Windows-only program.}}

A tutorial for using FriishProduce can be found [https://catmanfan.github.io/FriishProduce/tutorial on the developer's website].

Wii:FriishProduce

2025-01-26T21:19:29Z

MPGIII: Created page with "{{Infobox homebrew | image = FriishProduce.png | imagealt = Logo of FriishProduce | imagesize = 256px | for3ds = 0 | forwiiu = 0 | forswitch = 0 | forwii = 1 | developers = CatmanFan | website = https://catmanfan.github.io/FriishProduce https://catmanfan.github.io/FriishProduce | forwindows = 0 | formac = 0 | forlinux = 0 | forjava = 0 | github = CatmanFan/FriishProduce}} FriishProduce is a Wii/vWii channel injector/creator GUI. It can be used to create installable WADs..."

{{Infobox homebrew
| image = FriishProduce.png
| imagealt = Logo of FriishProduce
| imagesize = 256px
| for3ds = 0
| forwiiu = 0
| forswitch = 0
| forwii = 1
| developers = CatmanFan
| website = https://catmanfan.github.io/FriishProduce https://catmanfan.github.io/FriishProduce
| forwindows = 0
| formac = 0
| forlinux = 0
| forjava = 0
| github = CatmanFan/FriishProduce}}

FriishProduce is a Wii/vWii channel injector/creator GUI. It can be used to create installable WADs for older consoles, including for Virtual Console (VC) games, as well as for other platforms such as Adobe Flash and RPG Maker 2000/2003.

{{info|text=FriishProduce is a Windows-only program.}}

A tutorial for using FriishProduce can be found [on the developer's website, here](https://catmanfan.github.io/FriishProduce/tutorial/).

File:FriishProduce.png

2025-01-26T21:16:11Z

MPGIII:

3DS:Open agb firm

2024-07-29T21:58:46Z

MPGIII: /* Usage */ Correct filepath example

{{DISPLAYTITLE:3DS:open_agb_firm}}
{{Infobox homebrew
| title = open_agb_firm
| for3ds = 1
| forwiiu = 0
| github = profi200/open_agb_firm
| universaldb = 3ds/open_agb_firm
| githubtag = beta_2024-07-25
| forwindows = 0
| formac = 0
| forlinux = 0
| forjava = 0
| forswitch = 0
| forwii = 0
| developers = profi200
| version = 2024-07-25
| releasedate = 2024-07-25
}}
'''open_agb_firm''' is a bare-metal application for running Game Boy Advance games using the Nintendo 3DS's native GBA hardware capabilities.

== Features ==

open_agb_firm uses the 3DS's native capabilities to run GBA software, just like the original AGB_FIRM. The main difference is that it allows running ROMs from files on the SD card, instead of requiring them to be installed as digital games. Save files are also put on the SD card, making access to them far easier than AGB_FIRM.

Like AGB_FIRM, additional hardware features like accelerometer and camera are not supported. Games that depend on these features like {{iw|wikipedia|WarioWare: Twisted!}} and {{iw|wikipedia|Game Boy Camera}} will not work. The exception is the real-time clock which is implemented, so games that use this such as the third-generation Pokémon games can use it as normal.

== Installation ==

=== Universal-Updater ===
[[udb:3ds/open_agb_firm|open_agb_firm]] is available on Universal-DB and can be installed and updated with [[3DS:Universal-Updater|Universal-Updater]].

=== Manually ===
# {{GitHub|profi200/open_agb_firm/releases/latest|Download the latest release}} (the open_agb_firm <code>.7z</code> file)
# Extract the open_agb_firm <code>.7z</code> file using [https://www.7-zip.org/ 7-Zip] (or another appropriate utility for your computer's operating system)
# Copy <code>open_agb_firm.firm</code> from the extracted contents and place it in <code>/luma/payloads/</code>
# Copy the <code>3ds</code> folder from the extracted contents to the root of your SD card
#* If your computer asks to merge or overwrite anything, allow it

== Usage ==
{{Section WIP}}
Press and hold START while turning on the console to choose it through the Luma3DS chainloader. A reboot is required to select a different game.

ROMs can be placed anywhere on the SD card. Save files are put in <code>/3ds/open_agb_firm/saves</code> (e.g. if the game is at <code>/roms/Mario Kart.gba</code>, the save is at <code>/3ds/open_agb_firm/saves/Mario Kart.sav</code>).

=== Example ===

{{Tree list}}
* {{Tree icon|sd}} (root)
** {{Tree icon|d}} 3ds
*** {{Tree icon|d}} open_agb_firm
**** {{Tree icon|d}} saves
***** {{Tree icon|f}} '''Mario Kart.sav'''
***** {{Tree icon|f}} '''Pokemon Emerald.sav'''
**** {{Tree icon|f}} gba_db.bin
** {{Tree icon|d}} roms
*** {{Tree icon|f}} '''Mario Kart.gba'''
** {{Tree icon|d}} mygames
*** {{Tree icon|d}} gba
**** {{Tree icon|f}} '''Pokemon Emerald.gba'''
{{Tree list/end}}

== Configuration ==

Configuration settings are [https://github.com/profi200/open_agb_firm#configuration available on GitHub].

== See also ==

* [[3DS:GBA games]]

User:Thepikachugamer/Installing boot9strap (MSET9-Wii)

2024-06-01T05:22:13Z

MPGIII: Indicate which console "console" refers to

{{Page WIP}}

==What you Need==

*The latest release of [https://github.com/zoogie/MSET9/releases/latest MSET9] (the Release <code>.zip</code> file)
*The latest release of [https://github.com/Naim2000/MSET9-Wii/releases/latest MSET9-Wii] (the <code>.dol</code> file)
*a Wii with The Homebrew Channel installed

==Instructions==

===Section I - Prep Work===

#Power off your 3DS
#Insert your SD card into your computer
#Copy everything from the Release <code>.zip</code> file to the root of your SD card
#Create a folder named <code>apps</code> on your SD card (if it does not exist already)
#Create a folder named <code>MSET9-Wii</code> within the <code>/apps/</code> folder on your SD card
#Copy the MSET9-Wii <code>.dol</code> file to the <code>/apps/MSET9-Wii/</code> folder on your SD card, and rename it to <code>boot.dol</code>
#Safely eject your SD card from your computer
#Insert your SD card into your 3DS, and power it on

===Section II - Creating Extra Data===

#Power on your 3DS with your SD card inserted
#Open Mii Maker
#Wait for your 3DS to reach the "Welcome to Mii Maker" screen, then exit Mii maker
##You may see a "Creating extra data..." prompt, which indicates that the necessary data has been created
##If you only reach the normal Mii maker screen, exit Mii Maker and continue to the next step
#Launch System Settings
#Navigate to <code>Data Management</code> -> <code>Nintendo 3DS</code> -> <code>Extra Data</code>
#Ensure that Mii Maker is in the list of extra data
#Eject your SD card from your 3DS
#Insert your SD card into your Wii
#On your Wii, launch the Homebrew Channel, and launch MSET9-Wii from the Homebrew Channel.
#*If you are using the grid view, the application will have no icon.
#Select the option that corresponds to your 3DS's model and system version
#If you are asked to <code>Inject MSET9 now?</code>, press {{Key press|B}} to cancel.
#*If you receive any errors in the sanity checks, follow the provided instructions, or consult the [[User:Thepikachugamer/Installing boot9strap (MSET9-Wii)/Troubleshooting|troubleshooting]] page.
#Press {{Key press|HOME}} twice to exit the app
#Eject your SD card from your Wii

===Section III - MSET9===
{{Warning|text=Following these steps precisely is crucial to getting MSET9 to trigger. If you believe you made an error, restart this section.}}

#On the HOME menu, hover over System Settings ('''do not launch it!''')
#Power off your 3DS, then power it back on
#Press {{Key press|A}} to launch System Settings
#Navigate to <code>Data Management</code> -> <code>Nintendo 3DS</code> -> <code>Extra Data</code>
#'''Do not press any buttons or touch the screen.'''
#Eject your SD card from your 3DS
#Insert your SD card into your Wii
#Launch MSET9-Wii from the Homebrew Channel
#Select the option that corresponds to your 3DS's model and system version
#When prompted to <code>Inject MSET9 now?</code>, press {{Key press|A}} to confirm.
#You should see <code>[OK] MSET9 successfully injected, have fun!</code>
##Do not turn your Wii off. We will be using it again soon.
#Eject your SD card from your Wii, and insert it into your 3DS
#If the exploit was successful, your 3DS will have booted into the SafeB9SInstaller.
#*If you get stuck on a loading screen for longer than 10 seconds, skip to Section V

===Section IV - Installing boot9strap===

#When prompted, input the key combo given on the top screen to install boot9strap
#Once it is complete, press (A) to reboot your 3DS
#Your 3DS should have rebooted into the Luma3DS configuration menu
#*Luma3DS configuration menu are settings for the Luma3DS custom firmware. Many of these settings may be useful for customization or debugging
#*For the purpose of this guide, these settings will be left on default settings
#*If your 3DS shuts down when you try to power it on, ensure that you have copied <code>boot.firm</code> from the Luma3DS <code>.zip</code> to the root of your SD card
#Press (Start) to save and reboot
{{Luma3DS is default}}

===Section V - Removing MSET9===

#Power off your 3DS
#Eject your SD card from your 3DS, and insert it into your Wii
#Press {{Key press|A}} to continue
#You should see <code>[OK] MSET9 has been removed!</code>
#When prompted to <code>Try again?</code>, press {{Key press|B}} to cancel.
#Press {{Key press|Home}} to return to the Homebrew Channel.

Template:Soft redirect

2024-03-21T22:47:25Z

MPGIII: Link to soft redirect was broken

__NONEWSECTIONLINK__[[File:Softredirarrow.svg|64px|Soft redirect to:|link=]]{{#if:{{{rawlink|}}}|{{{rawlink}}}|[[:{{#invoke:String|match|1={{{1}}}|2=^:*(.-)$}}|{{{2|{{#invoke:String|match|1={{{1}}}|2=^:*(.-)$}}}}}]]}} This page is a [[https://en.wikipedia.org/wiki/Wikipedia:Soft_redirect soft redirect]].<noinclude>{{Documentation}}

3DS:GYTB

2024-01-24T00:00:29Z

MPGIII: Add error case discovered for pre-existing badges unable to be dumped

{{Infobox homebrew
| title = GYTB
| image = GYTB-Banner.png
| imagealt = GYTB banner as used on the HOME Menu
| for3ds = 1
| developers = MrCheeze
| version = 1.0
| releasedate = 2019-02-02
| github = MechanicalDragon0687/GYTB
| githubtag = 1.0
| universaldb = 3ds/gytb
}}
'''GYTB''' (an acronym for Give You This Budge) is a homebrew app for the 3DS, developed by [https://github.com/MrCheeze/GYTB MrCheeze]. It allows you to install image files as custom badges to display on your HOME Menu. GYTB only works on system firmwares 9.3 and above.

==Installing GYTB==

<tabber>
|-|Universal Updater=

# Power on the console
# Open '''Universal-Updater'''
# Tap the magnifying glass on the bottom screen, then search for '''GYTB'''
# Press {{B|A}} while hovering over '''GYTB''' from the list of homebrew
# Choose <code>GYTB.3dsx</code> for homebrew launcher or <code>GYTB.cia</code> for HOME screen installation
# Wait until the app installs
# Close '''Universal-Updater'''


|-|FBI=
{{FBI QR code
| name1 = CIA
| url1 = https://github.com/MechanicalDragon0687/GYTB/releases/download/1.0/GYTB.cia
| name2 = 3dsx
| url2 = https://hacksguidewiki.sfo3.digitaloceanspaces.com/hacksguidewiki/GYTB.3dsx
}}

|-|Manually as CIA=

* Download [https://github.com/MechanicalDragon0687/GYTB/releases/download/1.0/GYTB.cia GYTB.cia] (direct download)
* Install it using a CIA installer such as [[3DS:FBI|FBI]]


|-|Manually as 3dsx=

* Download [https://github.com/MechanicalDragon0687/GYTB/releases/download/1.0/GYTB_hax.zip GYTB_hax.zip] (direct Download)
* Copy the <code>3ds</code> folder from inside the <code>GYTB_hax.zip</code> onto the root of your SD card
** If you are using macOS, hold the {{Key press|Option}} key while dragging the folders to the root of your SD card, then click '''Merge'''

</tabber>

==Obtaining custom badges==
* Obtain images you want to use as custom badges
** Images must be <code>.png</code>s whose dimensions are divisible by 64px
** Images larger than 64x64 will be split into separate badges (eg. 64x128 will be split into two badges)
** The custom badge's name is set to whatever the filename of the badge originally was
* [https://themeplaza.art/badges Theme Plaza] has a large collection of such badge images
** If you get custom badges from Theme Plaza, look for and delete <code>preview.png</code>

==Installing custom badges==

<tabber>
|-|CIA=

# Create a <code>badges</code> folder on the root of your SD card
# Copy your badge <code>.png</code> files to the <code>badges</code> folder
# Reinsert your SD card into your console
# Power on your console and Launch '''GYTB''' from the HOME screen
* You should see your badges flash on the screen, and be sent back to the HOME Menu afterward


|-|3dsx=

# Create a <code>badges</code> folder in the same location as <code>GYTB.3dsx</code>
#*{{Tree list}}
#** {{Tree icon|sd}} (root)
#*** {{Tree icon|d}} 3ds
#**** {{Tree icon|d}} GYTB
#***** {{Tree icon|d}} badges
#***** {{Tree icon|f}} GYTB.3dsx
# Copy your badge <code>.png</code> files to the <code>badges</code> folder
# Reinsert your SD card into your console
# Power on your console and open the '''Homebrew Launcher'''
#* If you already have a '''Homebrew Launcher''' icon on the HOME Menu, use that
#* If you do not have this icon, do the following set of steps:
#*# Open '''Download Play'''
#*# Open [[3DS:Luma3DS/Rosalina|Rosalina]] (the most common keycombos for the menu are {{Key press|L|Down|SELECT}} and {{Key press|X|Y}}
#*# Go into '''Miscellaneous options''', then select '''Switch the hb. title to the current app'''
#*# Press {{B|B}} until you exit Rosalina, then close '''Download Play''' and reopen it - at this point, the Homebrew Launcher should appear
# Launch '''GYTB''' from the list of homebrew
* You should see your badges flash on the screen, and be sent back to the HOME Menu afterward

</tabber>

==Decorate with Badges==

# Tap on HOME menu settings in the top left of the HOME menu
# Tap on the new button titled "'''Decorate with Badges'''"
# Drag your custom badges from the top of the screen onto your HOME menu
#* To attach badges to folders, tap on the top right wrench icon and select "'''Attach Badge to Folder'''"
# Tap on the <code>X</code> or press the {{B|HOME}},{{B|B}}, or {{B|X}} buttons to exit the badge menu

== Troubleshooting ==

If '''GYTB''' causes an [[3DS:EXCEPTION|exception]] when you open it, it is usually one of two reasons:
# There is an image whose dimensions can't be divided by 64 in the <code>badges</code> folder
#* <code>preview.png</code> is a common instance of this, especially when downloading from Theme Plaza. Check for this file and delete it.
# There are more than 1000 images inside the <code>badges</code> folder
#* The 3DS can only have 1000 badges installed. This is a hard limit that cannot be bypassed; remove images until you are under the limit again.

If '''GYTB''' gives the error "'''badges folder is missing. WHAT IS WRONG WITH THE ELF.'''", it is for one of two reasons:
# If the error appears after saying "'''Writing to extdata...'''", your badges folder is either not present, misplaced, or misnamed.
# If the error appears after saying "'''Checking for preexisting Badge Arcade badges to dump...'''", then your pre-existing badges were unable to be dumped. Clear your badges in Badge Arcade's help desk and then try again.

[[Category:Nintendo 3DS guides]]
[[Category:Nintendo 3DS homebrew]]

3DS:GYTB

2024-01-04T18:28:51Z

MPGIII: /* Troubleshooting */

{{Infobox homebrew
| title = GYTB
| image = GYTB-Banner.png
| imagealt = GYTB banner as used on the HOME Menu
| for3ds = 1
| developers = MrCheeze
| version = 1.0
| releasedate = 2019-02-02
| github = MechanicalDragon0687/GYTB
| githubtag = 1.0
| universaldb = 3ds/gytb
}}
'''GYTB''' (an acronym for Give You This Budge) is a homebrew app for the 3DS, developed by [https://github.com/MrCheeze/GYTB MrCheeze]. It allows you to install image files as custom badges to display on your HOME Menu. GYTB only works on system firmwares 9.3 and above.

==Installing GYTB==

<tabber>
|-|Universal Updater=

# Power on the console
# Open '''Universal-Updater'''
# Tap the magnifying glass on the bottom screen, then search for '''GYTB'''
# Press {{B|A}} while hovering over '''GYTB''' from the list of homebrew
# Choose <code>GYTB.3dsx</code> for homebrew launcher or <code>GYTB.cia</code> for HOME screen installation
# Wait until the app installs
# Close '''Universal-Updater'''


|-|FBI=
{{FBI QR code
| name1 = CIA
| url1 = https://github.com/MechanicalDragon0687/GYTB/releases/download/1.0/GYTB.cia
| name2 = 3dsx
| url2 = https://hacksguidewiki.sfo3.digitaloceanspaces.com/hacksguidewiki/GYTB.3dsx
}}

|-|Manually as CIA=

* Download [https://github.com/MechanicalDragon0687/GYTB/releases/download/1.0/GYTB.cia GYTB.cia] (direct download)
* Install it using a CIA installer such as [[3DS:FBI|FBI]]


|-|Manually as 3dsx=

* Download [https://github.com/MechanicalDragon0687/GYTB/releases/download/1.0/GYTB_hax.zip GYTB_hax.zip] (direct Download)
* Copy the <code>3ds</code> folder from inside the <code>GYTB_hax.zip</code> onto the root of your SD card
** If you are using macOS, hold the {{Key press|Option}} key while dragging the folders to the root of your SD card, then click '''Merge'''

</tabber>

==Obtaining custom badges==
* Obtain images you want to use as custom badges
** Images must be <code>.png</code>s whose dimensions are divisible by 64px
** Images larger than 64x64 will be split into separate badges (eg. 64x128 will be split into two badges)
** The custom badge's name is set to whatever the filename of the badge originally was
* [https://themeplaza.art/badges Theme Plaza] has a large collection of such badge images
** If you get custom badges from Theme Plaza, look for and delete <code>preview.png</code>

==Installing custom badges==

<tabber>
|-|CIA=

# Create a <code>badges</code> folder on the root of your SD card
# Copy your badge <code>.png</code> files to the <code>badges</code> folder
# Reinsert your SD card into your console
# Power on your console and Launch '''GYTB''' from the HOME screen
* You should see your badges flash on the screen, and be sent back to the HOME Menu afterward


|-|3dsx=

# Create a <code>badges</code> folder in the same location as <code>GYTB.3dsx</code>
#* Usually <code>sd:/3ds/</code> or <code>sd:/3ds/GYTB/</code>
# Copy your badge <code>.png</code> files to the <code>badges</code> folder
# Reinsert your SD card into your console
# Power on your console and open the '''Homebrew Launcher'''
#* If you already have a '''Homebrew Launcher''' icon on the HOME Menu, use that
#* If you do not have this icon, do the following set of steps:
#*# Open '''Download Play'''
#*# Open [[3DS:Luma3DS/Rosalina|Rosalina]] (the most common keycombos for the menu are {{Key press|L|Down|SELECT}} and {{Key press|X|Y}}
#*# Go into '''Miscellaneous options''', then select '''Switch the hb. title to the current app'''
#*# Press {{B|B}} until you exit Rosalina, then close '''Download Play''' and reopen it - at this point, the Homebrew Launcher should appear
# Launch '''GYTB''' from the list of homebrew
* You should see your badges flash on the screen, and be sent back to the HOME Menu afterward

</tabber>

==Decorate with Badges==

# Tap on HOME menu settings in the top left of the HOME menu
# Tap on the new button titled "'''Decorate with Badges'''"
# Drag your custom badges from the top of the screen onto your HOME menu
#* To attach badges to folders, tap on the top right wrench icon and select "'''Attach Badge to Folder'''"
# Tap on the <code>X</code> or press the {{B|HOME}},{{B|B}}, or {{B|X}} buttons to exit the badge menu

== Troubleshooting ==

If '''GYTB''' causes an [[3DS:EXCEPTION|exception]] when you open it, it is usually one of two reasons:
# There is an image whose dimensions can't be divided by 64 in the <code>badges</code> folder
#* <code>preview.png</code> is a common instance of this, especially when downloading from Theme Plaza. Check for this file and delete it.
# There are more than 1000 images inside the <code>badges</code> folder
#* The 3DS can only have 1000 badges installed. This is a hard limit that cannot be bypassed; remove images until you are under the limit again.
If '''GYTB''' gives the error "'''badges folder is missing. WHAT IS WRONG WITH THE ELF.'''", then your badges folder is either not present, misplaced, or misnamed.

[[Category:Nintendo 3DS guides]]
[[Category:Nintendo 3DS homebrew]]