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)
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.
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.
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.
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 drivers. Flatpaks have the same issue UNLESS you install theofficialgman's flatpak tegra BSP by running anything in the L4T-Megascript or from the pins in #ubuntu. 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
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
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