3DS:GYTB: Difference between revisions

(21 intermediate revisions by 6 users not shown)

Line 1:

==~~Required Reading==~~

{{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]].}}

GYTB (Give ~~you this badge~~) is a homebrew app for the ~~3ds that~~ allows you to ~~get~~ custom badges. GYTB only works on system firmwares 9.2 and above.

{{Infobox homebrew

| title = GYTB

| image = GYTB-Banner.png

| imagealt = GYTB banner as used on the HOME Menu

| for3ds = 1

| developers = MrCheeze

| version = 1.0

| releasedate = 2019-02-02

| github = MechanicalDragon0687/GYTB

| githubtag = 1.0

| universaldb = 3ds/gytb

}}

'''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==

|-|Universal-Updater=

# 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'''

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

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

|-|Manually as 3dsx=

* 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'''

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

~~==What You Need==~~

*[https://hacksguidewiki.sfo3.digitaloceanspaces.com/hacksguidewiki/GYTB.zip GYTB]

*Access to the homebrew Launcher

==Instructions==

=== Section I - Prep Work ===

#~~Power off~~ your ~~device~~

|-|CIA=

#~~Insert~~ your SD card into your ~~computer~~

#~~Place~~ the ~~3ds~~ folder ~~from~~ the GYTB.~~zip onto~~ the ~~root of~~ your SD card.

===Section I - Prep Work===

*If you are ~~using a Mac~~, ~~hold~~ the ~~Option key while dragging~~ the ~~folders~~ to the ~~root~~ of your ~~SD card~~, ~~then click “Merge”~~

# 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

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

|-|3DSX=

===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 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 do not have this icon, do the following set of steps:

#*# Open '''Download Play'''

#*# 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

#* You should see your badges flash on the screen, and be sent back to the HOME Menu afterward

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

~~=== Section II - Launching~~ GYTB ~~===~~

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

#* <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

#* 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.

~~#Open the Homebrew Launcher using any method~~

If '''GYTB''' gives the error "'''WHAT IS WRONG WITH THE ELF.'''", it is for one of two reasons:

~~#Launch~~ GYTB ~~from~~ the ~~list~~ of ~~homebrew~~

# If the error appears after saying "'''Writing to extdata...'''", your badges folder is either not present, misplaced, or misnamed.

*If ~~followed properly~~, ~~you should see~~ your badges ~~flash on~~ the ~~screen~~, ~~and~~ be ~~sent back to the home menu~~.

# 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 homebrew]]