8000
Skip to content

Instantly share code, notes, and snippets.

@masagrator

masagrator/HowToReadFPS.md Secret

Last active February 23, 2026 19:34
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save masagrator/65fcbd5ad09243399268d145aaab899b to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save masagrator/65fcbd5ad09243399268d145aaab899b to your computer and use it in GitHub Desktop.
Download ZIP
How to setup everything so you can read FPS with Status Monitor and manipulate FPS with FPSLocker
Raw
HowToReadFPS.md

Atmosphere CFW is required. SX OS and other CFWs are not supported. It's advised to use Atmosphere's USB Transfer Tool homebrew to transfer files. If you use Hekate's USB Mass Storage and you will be putting files using any other Operating System than Windows, you must run Hekate's Archive Bit Fixer after putting all files. This tutorial is only for Atmosphere 1.8.0+ users

  1. Download newest SaltyNX release from HERE, unpack zip file, copy both folders (SaltySD and atmosphere) to the root of your sdcard, accept any popup about overwriting folders.
  2. Download newest Ultrahand release (sdout.zip) from HERE, unpack it, copy all unpacked folders to the root of sdcard, accept any popup about overwriting folders.
  3. Download Status Monitor Overlay release from HERE, copy Status-Monitor-Overlay.ovl to switch\.overlays folder. It may not be visible in USB Mass Storage, but it's there.
  4. Download FPSLocker release from HERE, copy FPSLocker.ovl to switch\.overlays folder. It may not be visible in USB Mass Storage, but it's there.
  5. Download sys-clk newest version from HERE, copy all 3 folders to the root of sdcard, accept any popup about overwriting folders.
  6. Download sys-dock newest version from HERE, copy all 2 folders to the root of sdcard, accept any popup about overwriting folders.
  7. Restart Switch, now you can access overlays by pressing all 3 buttons at once: L, D-pad down and R-stick (aka pressing it).
  8. If you installed sys-dock from point 6, open sys-dock overlay, go to Toggle patches, enable "no_bw_downgrade" if you have Switch OLED, restart Switch. If you see glitchy horizontal lines on any Switch, enable force_full_render_pass and restart Switch. Read sys-dock README for more informations in case if this won't work as expected.

FPSLocker has many patches available to download from inside overlay. If you don't want to connect your Switch online, you can download newest set of patches from FPSLocker Warehouse for games that need more things to be tweaked to get proper FPS boost.

In case of any other question read READMEs of those tools.

@oezkancodes
Copy link
Copy Markdown
oezkancodes commented Aug 2, 2024
  1. Restart Switch, now you can access overlays by pressing all 3 buttons at once: L, D-pad down and R-stick (aka pressing it).

I was not able to access the overlays, so I checked the config file for Tesla Menu, and it was L + R + Y. I hope this helps for anyone else struggling to open the overlay menu.

@masagrator
Copy link
Copy Markdown
Author
masagrator commented Aug 3, 2024 •
edited
Loading

You didn't follow instructions 1:1, potentially with leftover files from some cfw pack, and surprised it doesn't work as expected? 🙄

@kripax
Copy link
Copy Markdown
kripax commented Sep 21, 2024

Hello, I have a problem with turning on the Tesla menu on the Nintendo Switch Lite. I did everything according to these 7 points (instructions). Can you advise me where the error could have occurred, or what else needs to be done to make it work?

@FpswitchOC
Copy link
Copy Markdown
FpswitchOC commented Oct 7, 2024

Hi i have a freezing bug wen i try to start TOTK with dynamic fps mod and 4ifir OC.
Without the mod, game starts
After i reinstal everything, with newest saltyNX and Fpslocker, i get the fpslocker with "no nx-fps installed".

All Files work without problems on switch Oled. Same settings same Fw 18.1.0

Has anyone a solution maybe?

@masagrator
Copy link
Copy Markdown
Author
masagrator commented Nov 7, 2024

This is because that mod disabled allow_debug in npdm. Ask author of this mod to fix their stuff.

@LePirateCrow
Copy link
Copy Markdown
LePirateCrow commented Dec 27, 2024

Anyone know why the BOTW patch doesn't work anymore? I just get the error: 'This game is listed in warehouse, but with different version, other version has config available!' No matter what I do! All my other games have no issue applying the patches!

@getbiks
Copy link
Copy Markdown
getbiks commented Jan 11, 2025

Hello, I have a problem with turning on the Tesla menu on the Nintendo Switch Lite. I did everything according to these 7 points (instructions). Can you advise me where the error could have occurred, or what else needs to be done to make it work?

Hey did you manage to solve it? I too have Switch Lite and Tesla menu not showing any more after this

@gonkong
Copy link
Copy Markdown
gonkong commented Mar 2, 2025

Hello, I have a problem with turning on the Tesla menu on the Nintendo Switch Lite. I did everything according to these 7 points (instructions). Can you advise me where the error could have occurred, or what else needs to be done to make it work?

Hey did you manage to solve it? I too have Switch Lite and Tesla menu not showing any more after this

Check tesla/config.ini

Сouldn't start tesla until i checked config, i had settings L+R+DB_UP

@mlghitman
Copy link
Copy Markdown
mlghitman commented Mar 31, 2025

I've just downloaded these and tried loading up my game but now every single game I have is giving me "this software has closed due to an error". And the ovl menu is no longer working Aswell. What do I do?

@Anonymous42456
Copy link
Copy Markdown
Anonymous42456 commented May 7, 2025

I've just downloaded these and tried loading up my game but now every single game I have is giving me "this software has closed due to an error". And the ovl menu is no longer working Aswell. What do I do?

Same thing happened with Xenoblade X. The fps won't increase to 60fps. It's stuck at 30fps.

@mspykerez
Copy link
Copy Markdown
mspykerez commented Oct 1, 2025

@masagrator it seems Ultrahand Overlay has gained some traction over Tesla Menu
I assume that using Ultrahand Overlay will have the exact same effect as Tesla Menu or there is drawbacks here?

@masagrator
Copy link
Copy Markdown
Author
masagrator commented Oct 1, 2025 •
edited
Loading

I prefer recommending third party tools that are in stable phase, Ultrahand is very often updated with fixes for bugs it introduced which means it is not in stable phase (in last few days it got three new releases, all of them with some bugfixes).

@PeeBeerBeach
Copy link
Copy Markdown
PeeBeerBeach commented Dec 10, 2025 •
edited
Loading

I used all the latest files from today and followed your guide. Atmosphere is also latest (1.10.1).
Running on Firmware 20.5.0 I can open the Tesla Menu and select any of the apps but whenever i start any of them my switch crashes (2168 - 0002)

Ok solved by installing Ultrahand

@sysuah
Copy link
Copy Markdown
sysuah commented Dec 15, 2025 •
edited
Loading

i installed and messed with my Switch all day to finally get it working
but only Once Upon a Katamari and GRID Autosport and Smash Ultimate i can set the custom FPS for so far , other games (JOJO ASBR, Dragonball Sparking Zero) just shows 'patch file doesnt exist' when I turn the overlay on to set the custom fps

*edit I just found out you have to navigate to Advanced Settings while in the Overlay menu and scroll down until you see that the plugin can be converted to patch file
now it is working as it should! :D

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
0