3DS:GYTB: Difference between revisions
From Hacks Guide Wiki
More actions
StarlitSkies (talk | contribs) be more specific about location of badges; add banner to {{Infobox homebrew}} |
update outdated warning |
||
| (16 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{mbox|type=content|text=This software has been superseded by Anemone3DS as of version 3.0.0, which provides more features and stability. You can find instructions for using Anemone3DS to install badges [[3DS:Custom_badges|here]].}} | |||
{{Infobox homebrew | {{Infobox homebrew | ||
| title = GYTB | | title = GYTB | ||
| Line 7: | Line 9: | ||
| 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. | ||
==Installation== | |||
<tabber> | <tabber> | ||
|-| | |-|Universal-Updater= | ||
<span> | |||
# 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 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) | ||
* 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> | |||
== | ==Badge requirements== | ||
* Custom badges must be <code>.png</code>(s) whose dimensions are divisible by 64 pixels | |||
* [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> | |||
* The custom badge's name is set to whatever the filename of the badge is | |||
* Images larger than 64x64 will be split into separate badges (eg. 128x128 will be split into four badges) | |||
** Badges split in this way will share the same name or app shortcut | |||
* The most badges you can install at a time is 1,000. If you attempt to install more than 1,000 badges, GYTB will crash. | |||
===Shortcuts=== | |||
Custom badges can be made into shortcuts to launch system applications; a list of compatible titles can be found [[3dbrew:Title_list#00040010_-_System_Applications|here]]. To create a badge shortcut, rename the badge so the TIDLow of the system app is between the first and second period of the file name, like so: <code>BadgeName.<TIDLow>.png</code>. For example, a file named <code>settings.00021000.png</code> would create a badge named settings that launches USA System Settings (mset). Badges made into shortcuts will display the banner of the application they launch, rather than being a pin; applications without a banner will display a default banner instead. | |||
# | |||
== | ==Instructions== | ||
<tabber> | |||
|-|CIA= | |||
<span> | |||
===Section I - Prep Work=== | |||
# 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 | ===Section II - Installing Badges=== | ||
# | # 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> | |||
=== Section | |-|3DSX= | ||
<span> | |||
# | ===Section I - Prep Work=== | ||
# | # 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 | |||
=== Section | ===Section II - Installing Badges=== | ||
# | # 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 100: | ||
#*# 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> | |||
</ | ===Section III - 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 119: | ||
# 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. | |||
[[Category:Nintendo 3DS guides]] | [[Category:Nintendo 3DS guides]] | ||
[[Category:Nintendo 3DS homebrew]] | [[Category:Nintendo 3DS homebrew]] | ||