Jump to content

Goldleaf 0.8

Conéctate para seguir esto  

¿Quieres enterarte al momento de las nuevas descargas? Síguenos en Twitter!

1 Screenshot

Goldleaf is multipurpose homebrew tool for Nintendo Switch.

If you are looking for Tinfoil, this is Tinfoil's safer and way more extended evolution.

Goldleaf has a very similar concept to FBI, which is a similar tool for Nintendo 3DS homebrew.

These are its main features:

  • SD card browser: A simple but fully equiped file browser for the SD card, supporting several file formats (such as NSP, NRO, NACP, NXTheme, JPEG, tickets...), and with support for copying, pasting, renaming, deleting and creating files and directories.
  • Console memory browser: Same browser but to be used with NAND partitions, which also warns when writing or deleting content as it can be dangerous.
  • Remote PC browser: Via this feature, one can browse a PC's drives like any other filesystem, connected by a USB-C cable.
  • Content manager: Browse any kind of content in your SD card, console memory or game cartridge. You can browse all the NCAs, and as title options, you can remove the content, or export it as a NSP. NAND SYSTEM contents (system titles or contents) aren't allowed to be deleted. Invidual contents such as updates or DLC can be removed individually. You have also the option to remove unused tickets or tickets belonging to contents, plus the options to reset launch version (in order to remove the update nag) or to export base, updates or DLCs to installable NSPs.
  • Web browser (console's web-applet): Using the console's web applets, Goldleaf allows to search and navigate through web pages. However, this can only be accessed if launched from the forwarder for technical reasons.
  • User account manager: Select a user account, and easily change things as the user's nickname or even delete it. Via the file browsers you can replace a user's icon with a JPEG image, but it can be a risky action. The icon needs to be a valid JPEG, with 256x256 dimensions. Goldleaf checks if the icon is valid to replace the other one. Linked accounts can also be unlinked (locally).
  • Console or Goldleaf settings: In this menu you can manage the console's update (view it's version or dump it as a directory installable with Choi or a NSP), and pending update in case it's present (auto-downloaded updates, which can also be viewed, dumped or deleted)

Among all this features, Goldleaf is a very intuitive tool, with a fancy UI, and fully translated into 5 different languages: English, Spanish, German, French, Italian and Dutch.


Common controls

  • (LR-stick / R-stick / D-pad) Move through the current menu
  • (ZL / ZR) Show a dialog to shut down or reboot the console.
  • (Plus / +) Show a dialog with this information.

NRO-only controls

  • (Minus / -) Exit the application in order to return to hbmenu.


NSP installs

Always keep in mind that installing NSPs can be a very easy way to get banned. If you use airplane mode and special DNSs like 90DNS, there is a smaller chance to get banned.

NEVER install untrusted NSPs. Goldleaf doesn't do any special verification, so please make sure that what you decide to install was obtained from trustworthy sources.


Tickets represent a game purchase, but technically speaking, you can't boot a title if the ticket isn't present (in case the title requires the ticket).

NSPs which don't have (nor require) a ticket are "standard crypto" NSPs. Standard-crypto titles aren't offical (usually reconverted content to avoid importing tickets).

Goldleaf will display whether a ticket is present or not, and if so, it's titlekey. Titlekeys are required to decrypt and access titles' content which require a ticket. Otherwise, they are undecryptable, hence unlaunchable by the system.

TL;DR: Always try to avoid untrusted NSPs, and if you go ahead and install CDN NSPs with tickets, avoid going online, or use special tools such as 90DNS, or you'll be banned for sure.

Quark and remote PC

Quark is a PC tool, with a fancy UI and made in Java, in order to help Goldleaf with the remote PC option. It should work on Windows, Linux or Mac.

Only requirement for Quark to work is JRE/JDK 8u60 or higher.

One time setup:

  1. Download Zadig
  2. Open Goldleaf and connect your Switch via USB with your PC
  3. Open Zadig
  4. Click "Options" and select "List all devices"
  5. Select the Switch from the drop-down menu
  6. Change the driver (right next to the green arrow) to "libusbK"
  7. Click on the button below "Install WCID Driver" or "Replace Driver"
  8. Done. Now you can use Goldleaf and Quark to directly access your PC!

Note: To use it correctly, make sure you open Goldleaf and connect the Switch with your PC before you launch Quark. Nevertheless, Quark will warn when USB connection is gone or no USB connection is found.


Goldleaf is released along with a NSP, in order to launch Goldleaf as an installed title, and take advantage of extra RAM and features such as web browsing.

The NSP is a forwarder since 0.6, what means that, instead of having Goldleaf's source inside the NSP, it simply loads the NRO from the SD card, meaning that only the NRO should be updated instead of having to reinstall the NSP.

Goldleaf's forwarding code tries to locate Goldleaf (Goldleaf.nro) in sd:/switch/ and sd:/switch/Goldleaf/. If it isn't found, an error message will be displayed.


Goldleaf supports the customization of colors, assets and other options via a JSON file located at Goldleaf's folder: sd:/switch/Goldleaf/settings.json.

    "general": {
        "customLanguage": "es",
        "keysPath": "/switch/prod.keys",
        "externalRomFs": "/switch/Goldleaf/theme/rom"
    "ui": {
        "background": "#aabbccdd",
        "base": "#aabbccdd",
        "baseFocus": "#aabbccdd",
        "text": "#aabbccdd",
        "menuItemSize": 80
    "installs": {
        "ignoreRequiredFwVersion": false

If a certain attribute isn't present Goldleaf will use default values. For colors, Goldleaf will initially load default light/dark themes according to the console's theme color, and later, colors present in the JSON will be used instead of default theme ones.


Via RomFs replacement, when Goldleaf tries to locate, for instance, romfs:/FileSystem/FileDataFont.ttf resource font, if romfsReplace is true and romfsReplacePath is, for instance, /switch/Goldleaf/testromfs, Goldleaf will look if sd:/switch/Goldleaf/testromfs/FileSystem/FileDataFont.ttf exists and use it if so, otherwise will use RomFs's one.

So, via this configurations, UI's images, resources, element sizes and even translations (using custom JSON translations) can be used, plus some more assets which will be added in future updates.

Known bugs

  • On Atmosphère and SX OS, exiting Goldleaf via HOME menu (as a NRO) seems to crash the system on 7.x firmwares due to a weird USB bug present on that specific versions. Any non-7.x firmware doesn't have this issue.
  • Apparently, after browsing (more than 4 times?) and then browsing (specific?) empty directories crashes Goldleaf. This issue is strangely common and needs to be looked into.

Credits and support

The main concepts of Goldleaf are and have been developed by me (XorTroll), but without the effort and support of many others, this project wouldn't have been a thing:

  • Adubbz and all the (old) Tinfoil contributors, for their huge work with title installing.
  • C4Phoenix, for his awesome work doing this project's logo, and the GIF displayed when launching the installed forwarder.
  • All the graphics except Goldleaf's logo (see credit above) were grabbed from Icons8.
  • 2767mr, for all the support given in Goldtree.
  • developer.su for NS-USBloader, which helped a lot on the development of Quark, mainly on the usage of usb4java and the base of a multi-platform JavaFX Java project.
  • Simon for his libusbK implementation for C#, which has made Goldtree client possible.
  • shchmue and blawar for the system to get tickets from system save data without breaking anything, found in Lockpick.
  • Translators: unbranched and exelix for Italian, tiliarou and FuryBaguette for French, and LoOkYe and C4Phoenix for German.
  • All the testers, for reporting bugs and helping a lot with the project's development.

Que novedades incluye la versión 0.8




  • General
    • Updated to latest libnx. This simplifies the code, and fixes potential issues? old libnx could have had.
    • Some parts of the code were rewritten or simplified, in order to try to improve Goldleaf's performance. A lot of nonsense or unused code was removed, and much stuff was simplified thanks to latest libnx changes.
    • Removed forwarder support. There are less ban-baity ways to launch homebrew as applications (via uLaunch or using Atmosphere's title override)
  • Application
    • Fixed a bug where deleting the currently selected user would leave Goldleaf in a buggy state (because it would still think that the user is valid)
    • Now amiibo dumping is done via "debug" amiibo/NFP services. Since emuiibo intercepts user (and soon system) services, using debug services means Goldleaf will be able to dump real amiibos even if emuiibo is activated.
    • Custom exception/crash handling: now, when a crash happens (usually segmentation faults), it won't cause a fatal error, Goldleaf will instead save a simple crash report to /reports and exit normally. Same thing for fatal crashes, which also log fatal reports there.
    • Now rebooting will reboot to RCM/payload, same way as if you rebooted from HOME menu's power menu.
    • The web browser system was improved, adding now a custom menu, and the possibility to save a page as a bookmark after having browsed it.
    • Added an integrated emuiibo v0.4.0 manager! This simplifies a lot using virtual amiibos:
      • Unlike other managers, Goldleaf checks the amiibo and attempts to get its picture from AmiiboAPI, otherwise displays a default icon.
      • You can change emuiibo's status (on, on for one use and off) and select a certain amiibo to use.
  • Quark / USB
  • Quark's target version was changed to Java 9 or higher, since trying to support Java 8 too made it complicated to get it working.
  • USB system was changed, and it won't work with previous versions (latest Goldtree for instance, which supported up to 0.7.3)
  • Fixed file/directory copying between different filesystems (SD and PC in this case), so it should work fine now ?
  • Now Goldleaf takes advantage of string descriptors on its USB communications:
    • Goldleaf's USB will have "Goldleaf" as the product string, so Quark can identify if the homebrew detected is actually Goldleaf. This particular change kills compatibility with any previous versions.
    • Goldleaf also sets it's version as the serial number descriptor, so Quark can use it. Development builds have "-dev" after the version ("0.8.0-dev", for instance), which will make Quark warn about its possible unstability.
  • Quark now displays the time anything was logged in the log box. That way, one can easily identify if USB connection is still working, for instance, with installs or long file copying.


  • General
    • Now the console's supported key generation is read from BOOT0 (it was hardcoded manually before) - this means that Goldleaf won't have to be updated in new console updates to fix key mismatch errors! Thus, 9.0.1 support was also fixed.
  • Updates
    • Goldleaf's updater is broken on 0.7.2 (and probably lower versions). PLEASE, DON'T USE IT TO UPDATE TO 0.7.3!. Luckily, it is fixed for this version, so next versions (0.7.x, 0.8...) should download fine when they get released soon.
    • Pending update detection was barely broken, but has been fixed too. As mentioned in previous releases, you can export it to install it safely with ChoiDujourNX, and delete it from system after that.

¿Tienes alguna duda, petición o aporte? Utiliza el foro!

  • Crear nuevo...