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}}
Gruetzig (talk | contribs)
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 = MrCheeze/GYTB
| 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 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.
 
This page will explain both how to install and how to use this app.


==Installation==


<tabber>
<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 ===
==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.


# Power off the console
===Shortcuts===
# Insert your SD card into your computer
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.
# 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 ===
==Instructions==


# Power on the console
<tabber>
# Open the Homebrew Launcher using any method
|-|CIA=
# Launch '''GYTB''' from the list of homebrew
<span>
* If followed properly, you should see your badges flash on the screen, and be sent back to the HOME Menu afterward.
===Section I - Prep Work===
 
# Create a <code>badges</code> folder on the root of your SD card
|-|Universal Updater=
# Copy your badge <code>.png</code> files to the <code>badges</code> folder
 
# Reinsert your SD card into your console
== What You Need ==
<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 - Prep Work ===


# Power off the console
===Section II - Installing Badges===
# Insert your SD card into your computer
# Power on your console and Launch '''GYTB''' from the HOME screen
# Create the folder <code>badges</code> on the root of your SD card
#* You should see your badges flash on the screen, and be sent back to the HOME Menu afterward
# Obtain images you want to use as badges and put them into the <code>badges</code> folder
</span>
#* 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
# Reinsert your SD card into the console


=== Section II - Installing GYTB ===
|-|3DSX=
 
<span>
# Power on the console
===Section I - Prep Work===
# Open '''Universal-Updater'''
# Create a <code>badges</code> folder in the same location as <code>GYTB.3dsx</code>
# Tap the magnifying glass on the bottom screen, then search for '''GYTB'''
#*{{Tree list}}
# Press {{B|A}} while hovering over '''GYTB''' from the list of homebrew
#** {{Tree icon|sd}} (root)
# Choose <code>GYTB.3dsx</code>
#*** {{Tree icon|d}} 3ds
# Wait until the app installs
#**** {{Tree icon|d}} GYTB
# Close '''Universal-Updater'''
#***** {{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 III - Launching GYTB ===
===Section II - Installing Badges===
# 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
#* 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
* 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>


</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]]