Frequently Asked Questions
Common questions and answers about Switch theming using NXThemes Installer and Atmosphère CFW.
My Switch crashes on boot after installing a theme
This is fixable, and most likely caused by the Lockscreen theme. Remaking the theme won't help.
Try these steps:
- Uninstall the themes: delete the
0100000000001000and/or0100000000000811folders insd:/atmosphere/contents - Make sure you're on the latest version of the NXThemes Installer app (check for updates in the HBAppStore).
- Make sure NXThemes Installer can download the latest patches by being connected to WiFi, or install them manually from here.
- Try 'extract home menu' in the NXThemes Installer again.
- Then try installing your themes again, one by one.
Note: contents is called titles on Atmosphère version 0.9.4 and below.
My theme does not show all app icons (12 or less) on the Home Screen. How can I access the rest?
Short answer: Your choices are to either:
- Install random apps to meet the minimum amount of 13
- Install a different theme that uses a different layout
Long answer: The theme you installed uses a custom 'layout': the layout of the menu components (game icons, user icons, time, etc.). That custom layout removes a few of the app icons from the home menu to make it more minimal. There is no way to access these. The Switch simply doesn't display the all-apps button when you have less than 13 apps installed.
Do themes work on Firmware X.X? / Themes don't work on X.X
The NXThemesInstaller will try to download the latest patches for your firmware version. Every FW update will break lockscreen themes. If a firmware update released only recently, it may take some time for the developer to release the required patches. The application will download them as soon as they are available. You need internet, so make sure you've set up Atmosphere's dns mitm or 90dns, or install them manually from here.
Can I create animated themes?
Short answer: Yes, but low quality and with a lot of effort. Long answer: The Switch menus do not have enough memory to handle more than one extra background image. Animated themes would require multiple background images, which would exceed the memory limit and cause crashes. There are some who have done it, but it requires advanced knowledge of Switch theming, results in very low-resolution backgrounds, and is not recommended for most users. View the guide here. Example themes:
My Switch crashes on boot after I installed a font
- Cause 1: You installed a font that was too large in file size (maximum file size being 1.9MB). You can remove your installed custom font data by navigating to
sd:/atmosphere/contentsand deleting the0100000000000811folder. - Cause 2: You installed a font that wasn't the right file type (e.g. .otf). You can remove your installed custom font data by navigating to
sd:/atmosphere/contentsand deleting the0100000000000811folder.
Note: contents is called titles on Atmosphère version 0.9.4 and below.
The NXTheme installer crashes when I launch it
This is probably due to the archive bit being set on either the app or the .nxtheme files. This is usually the result of copying files to a microSD card via a Mac. If you are experiencing this issue, try running the archive bit fixer utility via hekate for all files.
This can be done by booting into hekate and going to Tools > Arch bit • RCM Touch • Pkg1/2 > Fix Archive Bit.
Can I swap themes without rebooting?
Currently no, the OS can't swap themes on the go and it does need a reboot. That said, Atmosphère cfw has a feature called reboot to payload that lets you reboot your console without having to go into RCM a second time.
A theme shows no bottom bar on the screenshot, but when I install it it's there
The creator messed up, no way to fix it really unless they update their theme.
Some parts of the home menu disappear with certain themes
This depends on the layout of the theme, some may hide on purpose the news or eshop applets or other parts of the home menu. Some layouts may hide some games from the end of the list, the only way to access those games is to use the all apps menu. The all apps button shows up only if there are at least 13 titles installed, currently there's no way around that.
How do I create my own layouts? Where can I find details on how the menu works? Where can I find the user icons or <insert component name here>?
You can try to find what you need on LayoutDocs
It covers:
- How to get started (set up the required tools, tips)
- Where you can find components
- Examples for specific changes
- Layout/theming related word definitions
It's far from done and if you have anything to add, feel free to let me know or create a PR yourself (see the main page)
If you still didn't manage to find a component, I'm pretty confident I am able to help you. DM migush or send a message in #switch-support
How do I publish my layouts on Themezer?
Read the documentation here, or I can process it for you, but I need two things:
- The layout
jsonfile - A transparent
pngyou get by diffing your theme (TODO UPDATE)
DM me or ping @migush in #switch-support with the files
How do I mod my Switch?
Start here: Nintendo Homebrew Guide
Outdated Questions
"ResidentMenu not found in lyt dir"
You're following an outdated guide, download latest version of the theme installer, it will extract all the needed files automatically.
What's the difference between nxtheme and szs?
NXThemes works on every supported firmware and it's legal to share so it's allowed on websites like GBATemp or Reddit. SZS is firmware dependent (aka crashes on the wrong firmware) and NOT legal to share. You shouldn't be posting szs links on other sites. To install NXThemes you need the NXThemes Installer homebrew (which can install szs files as well if you'd like) https://github.com/exelix11/SwitchThemeInjector/releases
Q: CONNECTION ISSUES
SXOS' Stealth Mode is known to cause issues with the NX app.
A solution to this problem:
- Configure 90dns (Google how to)
- Disable stealth mode
- Open the app and let it load results
- Enable stealth mode
- (Optionally) remove 90dns
This should only need to be done once, until (I'm assuming) the SSL certificate expires.
In case the issue is back after a reboot, consider replacing Stealth Mode with incognito_rcm or 90dns.