Links

Common Issues

Switchroot (Android and Linux) issues and solution page.

Common Issues

DISCLAIMER: Switchroot will (and can) only provide support for our official builds which you can find here.

Android

Boot
Controls
WIFI
Bluetooth
Applications
Can't Flash Zips in TWRP
Be sure to get latest version of the zip you're trying to flash or make sure you are using the latest OTA (currently 04/08/2022)
Not booting
Ensure your SD fat32 partition matches the layout indicated by our guide Also make sure you read the install guide FULLY and did not skip any steps or substitute in older versions of zips or MindTheGApps/OpenGApps.
Motion Controls
If you have problems with autorotation, or motion controls in games, ensure that you have updated to the latest OTA. If you still feel like you have gyro drift, you can attempt to manually calibrate your gyro: Instructions for gyro.txt 1. Use a gyro tester app like Physics Toolbox 2. Find the average distance from zero for each axis (x, y, z) 3. Create switchroot/android/gyro.txt of the following form: x, y, z 1.0, 1.0, 1.0 (Yes, write 1 as 1.0 in the file)
Joycons/ProCons
If your joycons do not autopair in android, make sure that you have paired them in HorizonOS and dumped them in Hekate/NYX. Pro Controllers do not have autopair function. If you wish to use them via bluetooth in android, you will have to pair them manually in the bluetooth settings (reset whenever you use the controller with other OSs).
Unable to connect to wifi.
If you are unable to connect to your home WIFI network and have access to your WIFI router settings, try connecting via your 2.4GHz network or changing your 5Ghz channel to 40 or below.
Need to update offline.
If you don’t have wifi and can’t make it work, download the latest icosa-tab zip, unzip it, and put the lineage zip inside it on the root of your sd. Then flash it in twrp.
JoyCon/ProCon specific issues covered under the Controls tab. There are no other known common issues. Ask us in the Switchroot Discord Server if you are having problems.
Issue: My "insert application name here" does not show in the playstore or will not launch Answer: Certain app makers BLOCK devices or maintain a whitelist of allowed devices which can run their app. You can attempt to use one of the multiple device spoofing apps to see if spoofing your devices with another (such as the google pixel) allows you to run your desired application.

Linux

WIFI/Bluetooth
Applications
Stutter/FramePacing Issue when Handheld
Issue: WIFI or bluetooth stopped working after using my system when it was working before. Answer: Update to the L4T 5.0.0+. Ubuntu overwrites the Switch specific WIFI firmware on apt upgrade, this has been fixed in 3.4.2 and later.
I tried installing an app and it doesn't run
If you installed an app following a tutorial, or from a software makers website, its likely that it is an x86_64/amd64 application. The switch is an arm64 device and can NOT run these applications natively. Look for a native arm64 version of your app or alternatives.
My Snap or Flatpak package does not run well
Snaps do not have GPU hardware acceleration on L4T Linux due to nvidia propretary tegra drivers. Flatpaks have the same issue UNLESS you: A: Are using Ubuntu Jammy or Fedora which have Flatpak hardware acceleration out of the box B: Are using Ubuntu Bionic and use theofficialgman's flatpak tegra BSP by running anything in the L4T-Megascript or from the pins in #ubuntu. In most cases, you should prefer building your desired packages from source code, or using available deb or PPAs.
Nvidia Tegra and Desktop Drivers have FramePacing/Stutter issues when the display is Rotated. The switch's internal display is actually a Portrait display which is rotated to Landscape by the OS. This is an upstream driver bug that, to this day, is unfixed on Nvidia Xorg Drivers. Originally tracked via this issue on nvidia forums: https://forums.developer.nvidia.com/t/very-poor-framepacing-and-performance-when-using-xorg-rotation/178451 Now tracking under the new issue: https://forums.developer.nvidia.com/t/request-to-re-openvery-poor-framepacing-and-performance-when-using-xorg-rotation-178451-due-to-not-being-fixed-in-32-7-1/205322

Hardware

Display
Touchscreen
Internal Display
External Display Corruption
External Display No Video
Last modified 3mo ago