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
(be more specific about location of badges; add banner to {{Infobox homebrew}})
(Major rewrite of the page, to account for different badge folder locations depending on install format)
Line 15: Line 15:
This page will explain both how to install and how to use this app.
This page will explain both how to install and how to use this app.


==Installing GYTB==


<tabber>
<tabber>
|-|FBI (HBL)=
|-|Universal Updater=
 
<span>
== What You Need ==
 
* A 3DS console that can access the Homebrew Launcher
* The Homebrew Launcher {{GitHub|LumaTeam/Luma3DS/releases/latest|<code>boot.3dsx</code>}} on the SD root
* [[Media:GYTB.zip|GYTB.zip]]
 
==Instructions==
 
=== Section I - Prep Work ===
 
# Power off the console
# Insert your SD card into your computer
# Create the folder <code>badges</code> on the root of your SD card
# Obtain images you want to use as badges and put them into the <code>badges</code> folder
#* These images must be <code>.png</code>s whose dimensions are divisible by 64px - [https://themeplaza.art/badges Theme Plaza] has a large collection of such badge images
# Extract <code>GYTB.zip</code> into a folder
# Copy the <code>3ds</code> folder from inside the GYTB folder 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'''
# Reinsert your SD card into the console
 
=== Section II - Launching GYTB ===
 
# Power on the console
# Power on the console
# Open the Homebrew Launcher using any method
# Open '''Universal-Updater'''
# Launch '''GYTB''' from the list of homebrew
# Tap the magnifying glass on the bottom screen, then search for '''GYTB'''
* If followed properly, you should see your badges flash on the screen, and be sent back to the HOME Menu afterward.
# 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'''
</span>


|-|Universal Updater=
|-|FBI=
{{FBI QR code
| name1 = CIA
| url1 = https://github.com/MechanicalDragon0687/GYTB/releases/download/1.0/GYTB.cia
}}


== What You Need ==
|-|Manually as CIA=
<div>
<span>
* A 3DS console with [[3DS:Luma3DS|Luma3DS]] installed
* Download [https://github.com/MechanicalDragon0687/GYTB/releases/download/1.0/GYTB.cia GYTB.cia] (direct download)
* [[3DS:Universal-Updater|Universal-Updater]] installed to the console
* Install it using a CIA installer such as [[3DS:FBI|FBI]]
* A working internet connection
</span>
</div>


=== Section I - Prep Work ===
|-|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>


# Power off the console
==Getting custom badges==
# Insert your SD card into your computer
* Obtain images you want to use as custom badges
# Create the folder <code>badges</code> on the root of your SD card
** Images must be <code>.png</code>s whose dimensions are divisible by 64px
# Obtain images you want to use as badges and put them into the <code>badges</code> folder
** Images larger than 64x64 will be split into separate badges (eg. 64x128 will be split into two badges)
#* These images must be <code>.png</code>s whose dimensions are divisible by 64px - [https://themeplaza.art/badges Theme Plaza] has a large collection of such badge images
** The custom badge's name is set to whatever the filename of the badge originally was
# Reinsert your SD card into the console
* [https://themeplaza.art/badges Theme Plaza] has a large collection of such badge images
** If obtaining custom badges from Theme Plaza, look for and delete <code>preview.png</code>


=== Section II - Installing GYTB ===
==Installing custom badges==


# Power on the console
<tabber>
# Open '''Universal-Updater'''
|-|CIA=
# Tap the magnifying glass on the bottom screen, then search for '''GYTB'''
<span>
# Press {{B|A}} while hovering over '''GYTB''' from the list of homebrew
# Create a <code>badges</code> folder on the root of your SD card
# Choose <code>GYTB.3dsx</code>
# place your badge <code>.png</code> files in the <code>badges</code> folder
# Wait until the app installs
# Reinsert your SD card into your console
# Close '''Universal-Updater'''
# 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 III - Launching GYTB ===
|-|3dsx=
# Open the '''Homebrew Launcher'''
<span>
# 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>
# place your badge <code>.png</code> files in 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 83:
#*# 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
* If followed properly, 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>
</tabber>
 
==Placing custom badges==


</tabber>
# Tap on the house icon in the top right 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

Revision as of 00:13, 7 November 2023

GYTB (an acronym for Give You This Budge) is a homebrew app for the 3DS that can install image files as custom badges. GYTB only works on system firmwares 9.3 and above.

This page will explain both how to install and how to use this app.

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 screen installation
  6. Wait until the app installs
  7. Close 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

Getting 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 obtaining 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. place your badge .png files in 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
    • Usually sd:/3ds/ or sd:/3ds/GYTB/
  2. place your badge .png files in 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

Placing custom badges

  1. Tap on the house icon in the top right 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.