libnx ABI patcher - 为 Atmosphere 1.10+ 修补不兼容的自制软件

DISCLAIMER: THIS IS A MASSIVE HACK
Use this tool only for "abandonware" or homebrew that is no longer maintained. If the homebrew developer is still active, please ask them to update their application properly. Or if you can, do it yourself.

I made a quick web-based tool to patch not actively maintained homebrew.

As many have likely noticed by now, the firmware 21.0.0 introduced kernel changes, that broke all libnx-based homebrew. These changes were backported to all firmwares in Atmosphere 1.10.0+.

This tool has a single job - apply several small patches that should hopefully allow the homebrew to run without crashing on exit or randomly during runtime on all currently released all firmwares.

https://hbpatcher.alula.me/

So far I've personally tested it on ABI unpatched versions of: mGBA, 4TU homebrew App Store, melonDS port, Themezer-NX, JKSV, pkDex and some personal apps.

Generally, if the tool reports that the threadEntry() patch is applied, it should work. Note that this tool does not apply LNY2 new ABI marker, so the warning in hbmenu is still intact. This is intentional, to let you know that the binary is technically outdated - the homebrew will run just fine.

Last edited by alula, Nov 22, 2025

Good.

Does it work with ovl?

Great, I just patched the 8.10 english patched version of DBI installer and it works fine now. Thanks.

Great tool, thanks for making it.

This is so helpful. Thanks for making this!

Good.
Does it work with ovl?

I've tried and it seems to patch the ovl files.

Not tested on switch.

I've tried and it seems to patch the ovl files.
Not tested on switch.

Yeah that should be fine as a ovl is pretty much the same as a nro. You can even launch most of them using hbmenu or sphaira if you change the extension to nro.

Good.
Does it work with ovl?

yes they should, afaik .ovl are just renamed .nro files

Thanks for the tool. It works great!

Only soh/soh2 doesn't work. Seems the changes breaks the game (also via Album it's shows i need to run in full memory mode - but so it crashd)

Thanks for the tool. It works great!
Only soh/soh2 doesn't work. Seems the changes breaks the game (also via Album it's shows i need to run in full memory mode - but so it crashd)

If you find a fix for soh/2s2h let me know, I miss them

If you find a fix for soh/2s2h let me know, I miss them

I hope anyone can fix it^^ but "Data Abort" sound for me that it needs to be modified or something to get work again.

22.11.2025_22-00-14CUserskevinDesktop01763839945_0145511b6fea0000.log.jpg
141.9 KB · Views: 67

If you find a fix for soh/2s2h let me know, I miss them

if there's any non-functional homebrew please DM me

I've also just pushed a small update for the tool - .ovl extension is now accepted as well, corrected minor bugs, cleared up the text on About page

Thank you so so much for this!

if there's any non-functional homebrew please DM me
I've also just pushed a small update for the tool - .ovl extension is now accepted as well, corrected minor bugs, cleared up the text on About page

Tinfoil.nro doesn't work with this, it crashes on exit.

I recompiled that ovl in the 21 apps thread... But I don't know if it works or not...

This one is probably better, as it's based on TextReaderOverlay-NX and TextReaderOverlay-NX-Plus. I hope someone can recompile it.
https://github.com/soaresden/WalkthroughOverlay

Not sure if it will work (too many warnings on compilation):

I recompiled that ovl in the 21 apps thread... But I don't know if it works or not...

This one is probably better, as it's based on TextReaderOverlay-NX and TextReaderOverlay-NX-Plus. I hope someone can recompile it.
https://github.com/soaresden/WalkthroughOverlay

Not sure if it will work (too many warnings on compilation):

I tried that too and it crashes as well, I guess it needs changes more than rebuilding

new libnx decreases number of tls slots from 27 to 12. For some homebrew it is not enough and they should be rewritten.

This thread should be pinned

new libnx decreases number of tls slots from 27 to 12. For some homebrew it is not enough and they should be rewritten.

Definitely. But, ya know, there are times when people want to use homebrew that's been abandoned, or, I don't know, maybe an old version of a homebrew? I know, I know: people are weird.