Common Issues
Switchroot (Android and Linux) issues and solution page.
Last updated
Switchroot (Android and Linux) issues and solution page.
Last updated
DISCLAIMER: Switchroot will (and can) only provide support for our official builds which you can find .
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)
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).
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.
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.
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.
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: Now tracking under the new issue:
If you encounter an issue with your touch inputs not being recognized / registered in our projects, here is a list of step to guide you in determining the issue
Verify your whole touchscreen is working in HorizonOS. Use the touchscreen calibration/tester in the settings to verify.
Use the calibration tool in hekate
If your whole touchscreen is not working in HorizonOS, you may need to re-seat your switch touchscreen connector.
In case you touch inputs are still not getting recognized, take a screenshot of your display informations in Hekate as well as a log from the OS you're using and send it in our discord
No known common issues. Ask us in the Switchroot Discord Server if you are having problems.
If you see corruption on screen when docking: Undock and re-dock the switch, sometimes the HDMI/DP handhake process does not work correctly. This happens more frequently when using 4K display output.
This can be caused by one of a few issues:
If you are using an Original Nintendo Switch Dock, and you get no video output in Android/Linux and your switch display does NOT turn off, then you have an HDMI Hotplug issue. Try a different TV/monitor, or a branded/the official HDMI cable.
Why this happens: HorizonOS does NOT require HDMI hotplug to output via HDMI. Try it yourself, if you dock with an hdmi cable disconnected in HOS, the switch display will still turn off. Android/Linux require this feature (to make them compabile with hubs/docks so users can still use the internal display when HDMI is not plugged in).
If you are using an Original Nintendo Switch Dock, and you get no video output in Android/Linux and your switch display DOES turn off, then you likely have an HDMI handshake issue. Try a different TV/monitor, or a branded/the official HDMI cable. If your TV is 4K, try a 1080p or lower resolution one.
If you use 3rd party Dock/Hub does not produce video output but the official dock works: If your dock does not work in L4T Ubuntu 5.0.0, let us know in the Discord.