Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

3DS:GYTB: Difference between revisions

From Hacks Guide Wiki
m (cool)
m (various capitalization changes)
(2 intermediate revisions by one other user not shown)
Line 13: Line 13:
'''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.
'''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==
==Installing GYTB==


<tabber>
<tabber>
Line 22: Line 22:
# Tap the magnifying glass on the bottom screen, then search for '''GYTB'''
# Tap the magnifying glass on the bottom screen, then search for '''GYTB'''
# Press {{B|A}} while hovering over '''GYTB''' from the list of homebrew
# 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
# Choose <code>GYTB.3dsx</code> for Homebrew Launcher or <code>GYTB.cia</code> for HOME Menu installation
# Wait until the app installs
# Wait until the app installs
# Exit '''Universal-Updater'''
# Exit '''Universal-Updater'''
Line 49: Line 49:
</tabber>
</tabber>


==Badge requirements==
==Obtaining custom badges==
* Custom badges must be <code>.png</code>(s) whose dimensions are divisible by 64 pixels
* 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
* [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>
** 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===
==Installing custom badges==
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>
<tabber>
|-|CIA=
|-|CIA=
<span>
<span>
===Section I - Prep Work===
# Create a <code>badges</code> folder on the root of your SD card
# 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
# Copy your badge <code>.png</code> files to the <code>badges</code> folder
# Reinsert your SD card into your console
# Reinsert your SD card into your console
===Section II - Installing Badges===
# Power on your console and Launch '''GYTB''' from the HOME screen
# 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
* You should see your badges flash on the screen, and be sent back to the HOME Menu afterward
</span>
</span>


|-|3DSX=
|-|3dsx=
<span>
<span>
===Section I - Prep Work===
# Create a <code>badges</code> folder in the same location as <code>GYTB.3dsx</code>
# Create a <code>badges</code> folder in the same location as <code>GYTB.3dsx</code>
#*{{Tree list}}
#*{{Tree list}}
Line 88: Line 80:
# Copy your badge <code>.png</code> files to the <code>badges</code> folder
# Copy your badge <code>.png</code> files to the <code>badges</code> folder
# Reinsert your SD card into your console
# Reinsert your SD card into your console
===Section II - Installing Badges===
# Power on your console and open the '''Homebrew Launcher'''
# 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
Line 98: 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
* You should see your badges flash on the screen, and be sent back to the HOME Menu afterward
</span>
</span>
</tabber>
</tabber>


===Section III - Decorate with Badges===
==Decorate with Badges==


# Tap on HOME Menu Settings in the top left of the HOME Menu
# Tap on HOME Menu settings in the top left of the HOME Menu
# Tap on the new button titled "'''Decorate with Badges'''"
# Tap on the new button titled "'''Decorate with Badges'''"
# Drag your custom badges from the top of the screen onto your HOME Menu
# Drag your custom badges from the top of the screen onto your HOME Menu
Line 120: Line 110:
If '''GYTB''' gives the error "'''WHAT IS WRONG WITH THE ELF.'''", it is for one of two reasons:
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 "'''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.
# 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]]

Revision as of 10:19, 18 May 2024

GYTB (an acronym for Give You This Budge) is a homebrew app for the 3DS, developed by 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

  1. Power on the console
  2. Open Universal-Updater
  3. Tap the magnifying glass on the bottom screen, then search for GYTB
  4. Press A while hovering over GYTB from the list of homebrew
  5. Choose GYTB.3dsx for Homebrew Launcher or GYTB.cia for HOME Menu installation
  6. Wait until the app installs
  7. Exit Universal-Updater

  • Download GYTB.cia (direct download)
  • Install it using a CIA installer such as FBI

  • Download GYTB_hax.zip (direct Download)
  • Copy the 3ds folder from inside the GYTB_hax.zip onto the root of your SD card
    • If you are using macOS, hold the ⌥ Option key while dragging the folders to the root of your SD card, then click Merge

Obtaining custom badges

  • Obtain images you want to use as custom badges
    • Images must be .pngs 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
  • Theme Plaza has a large collection of such badge images
    • If you get custom badges from Theme Plaza, look for and delete preview.png

Installing custom badges

  1. Create a badges folder on the root of your SD card
  2. Copy your badge .png files to the badges folder
  3. Reinsert your SD card into your console
  4. 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

  1. Create a badges folder in the same location as GYTB.3dsx
      • SD card icon (root)
        • Folder icon 3ds
          • Folder icon GYTB
            • Folder icon badges
            • File icon GYTB.3dsx
  2. Copy your badge .png files to the badges folder
  3. Reinsert your SD card into your console
  4. 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:
      1. Open Download Play
      2. Open Rosalina (the most common keycombos for the menu are L++SELECT and X+Y
      3. Go into Miscellaneous options, then select Switch the hb. title to the current app
      4. Press B until you exit Rosalina, then close Download Play and reopen it - at this point, the Homebrew Launcher should appear
  5. 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

Decorate with Badges

  1. Tap on HOME Menu settings in the top left of the HOME Menu
  2. Tap on the new button titled "Decorate with Badges"
  3. 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"
  4. Tap on the X or press the HOME,B, or X buttons to exit the badge menu

Troubleshooting

If GYTB causes an exception when you open it, it is usually one of two reasons:

  1. There is an image whose dimensions can't be divided by 64 in the badges folder
    • preview.png is a common instance of this, especially when downloading from Theme Plaza. Check for this file and delete it.
  2. There are more than 1000 images inside the badges 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 "WHAT IS WRONG WITH THE ELF.", it is for one of two reasons:

  1. If the error appears after saying "Writing to extdata...", your badges folder is either not present, misplaced, or misnamed.
  2. 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.