Approver
509
edits
StarlitSkies (talk | contribs) (be more specific about location of badges; add banner to {{Infobox homebrew}}) |
m (capitalze Settings in HOME Menu Settings + the Homebrew Launcher) |
||
(12 intermediate revisions by 3 users not shown) | |||
Line 7: | Line 7: | ||
| version = 1.0 | | version = 1.0 | ||
| releasedate = 2019-02-02 | | releasedate = 2019-02-02 | ||
| github = | | github = MechanicalDragon0687/GYTB | ||
| githubtag = 1.0 | | githubtag = 1.0 | ||
| universaldb = 3ds/gytb | | universaldb = 3ds/gytb | ||
}} | }} | ||
'''GYTB''' (an acronym for Give You This Budge) is a homebrew app for the 3DS | '''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> | <tabber> | ||
|-| | |-|Universal-Updater= | ||
<span> | |||
# Power on the console | # Power on the console | ||
# Open the | # 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 the Homebrew Launcher or <code>GYTB.cia</code> for HOME Menu installation | |||
# Wait until the app installs | |||
# Exit '''Universal-Updater''' | |||
</span> | |||
|-| | |-|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= | |||
< | <span> | ||
* | * Download [https://github.com/MechanicalDragon0687/GYTB/releases/download/1.0/GYTB.cia GYTB.cia] (direct download) | ||
* [[3DS: | * Install it using a CIA installer such as [[3DS:FBI|FBI]] | ||
</span> | |||
</ | |||
|-|Manually as 3dsx= | |||
<span> | |||
* 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''' | |||
</span> | |||
</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= | |||
# | <span> | ||
# 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 | |||
</span> | |||
= | |-|3dsx= | ||
# | <span> | ||
# 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 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: | #* If you do not have this icon, do the following set of steps: | ||
Line 83: | Line 88: | ||
#*# Press {{B|B}} until you exit Rosalina, then close '''Download Play''' and reopen it - at this point, the Homebrew Launcher should appear | #*# 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 | # 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 | ||
</span> | |||
</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 == | == Troubleshooting == | ||
If '''GYTB''' causes an [[3DS:EXCEPTION|exception]] when you open it, it is usually one of two reasons: | 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 | # There is an image whose dimensions can't be divided by 64 in the <code>badges</code> folder | ||
Line 93: | Line 107: | ||
# There are more than 1000 images inside the <code>badges</code> folder | # 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. | #* 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 "'''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 guides]] | ||
[[Category:Nintendo 3DS homebrew]] | [[Category:Nintendo 3DS homebrew]] |