3DS:GYTB: Difference between revisions

GYTB
Developer(s)	MrCheeze
Console	Nintendo 3DS
Version	1.0 (February 2, 2019; 5 years ago)
Links
GitHub	MechanicalDragon0687/GYTB
Download
	Universal-DB; GitHub release;
	v; t; e;

Latest revision as of 11:00, 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

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

You can scan one of the QR codes below to download and install the program using FBI. To do this, start FBI, then go to "Remote Install", then "Scan QR Code".

QR codes for FBI
https://github.com/MechanicalDragon0687/GYTB/releases/download/1.0/GYTB.cia https://hacksguidewiki.sfo3.digitaloceanspaces.com/hacksguidewiki/GYTB.3dsx

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

Create a badges folder on the root of your SD card
Copy your badge .png files to the badges 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

Create a badges folder in the same location as GYTB.3dsx
- - (root)
    - 3ds
      GYTB
      badges
      
      GYTB.3dsx
Copy your badge .png files to the badges 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:
  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
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

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 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:

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.
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:

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.

@@ Line 1: / Line 1: @@
 {{Infobox homebrew
-| title = gytb
+| title = GYTB
-| developers = MechanicalDragon0687
+| image = GYTB-Banner.png
+| imagealt = GYTB banner as used on the HOME Menu
 | for3ds = 1
-| image =
+| developers = MrCheeze
-| imagealt =
 | version = 1.0
 | releasedate = 2019-02-02
@@ Line 11: / Line 11: @@
 | universaldb = 3ds/gytb
 }}
-'''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.
+'''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>
-|-|FBI (HBL)=
+|-|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>
-== What You Need ==
+|-|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
+}}
-* A 3DS console that can access the Homebrew Launcher
+|-|Manually as CIA=
-* The Homebrew Launcher {{GitHub|LumaTeam/Luma3DS/releases/latest|<code>boot.3dsx</code>}} on the SD root
+<span>
-* [[Media:GYTB.zip|GYTB.zip]]
+* 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>
-==Instructions==
+|-|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>
-=== Section I - Prep Work ===
+==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>
-# Power off your device
+==Installing custom badges==
-# Insert your SD card into your computer
-# 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'''
-=== Section II - Launching GYTB ===
+<tabber>
+|-|CIA=
-# Open the Homebrew Launcher using any method
+<span>
-# Launch '''GYTB''' from the list of homebrew
+# Create a <code>badges</code> folder on the root of your SD card
-* If followed properly, you should see your badges flash on the screen, and be sent back to the home menu.
+# Copy your badge <code>.png</code> files to the <code>badges</code> folder
+# Reinsert your SD card into your console
-|-|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
-== What You Need ==
+</span>
-<div>
-* A 3DS console with [[3DS:Luma3DS|Luma3DS]] installed
-* [[3DS:Universal-Updater|Universal-Updater]] installed to the console
-* A working internet connection
-</div>
-=== Section I - Installing GYTB ===
-# 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>
-# Wait until the app installs
-# Close '''Universal-Updater'''
-=== Section II - Launching GYTB ===
+|-|3dsx=
-# Open the '''Homebrew Launcher'''
+<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 do not have this icon, do the following set of steps:
 #*# Open '''Download Play'''
-#*# Open [[3DS:Luma3DS/Rosalina|Rosalina]] (the normal keycombo for this is {{Key press|L|Down|SELECT}}
+#*# 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
-* If followed properly, you should see your badges flash on the screen, and be sent back to the home menu.
+* You should see your badges flash on the screen, and be sent back to the HOME Menu afterward
+</span>
+</tabber>
-</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.
+# 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. Check for it and delete it.
+#* <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.
+# 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 "'''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]]