Skip to content

Troubleshooting

DeLFuS77 edited this page Oct 30, 2026 · 1 revision

Before opening an issue, Copy report puts the result of every file on the clipboard, with the version of NXPress and of the system. It does not include the keys.

"no prod.keys"

NXPress does not find the file of keys. Choose it in Settings › prod.keys, or put it next to NXPress or in ~/.switch. A file without header_key does not work. See Keys.

A file is damaged

A byte of the file does not match what it should hold. If it is a copy, copy it again; if it is a dump, dump it again. What to do, in its row, explains each error, with Copy the detail.

"the new file could only be checked in part"

A tool rewrote an NCA of the file (to take out its rights ID, for example), and one of its sections cannot be checked on its own. The new file is kept, but it does not replace the original, even with Delete originals once checked.

A game is marked Skipped

It has nothing to compress, and its row says why. See Compression › Games that are skipped.

"The new files may not fit"

Before it starts, NXPress checks that the new files fit on each drive and tells where they may not. Free some space, choose another folder in Save to, or Start anyway.

The FAT32 parts show as a folder

They are missing the archive bit. On Windows NXPress sets it; on other systems it is set with Hekate (Tools, Archive bit).

macOS does not let NXPress open

The app is not notarized: the first time, open it with right click, Open, or allow it in System Settings, Privacy & Security.

On Linux the window does not open

It needs GTK 3 and WebKitGTK 4.1. The command line works without them.

The computer is slow while NXPress works

Turn on Low priority in Advanced (--low-priority), or lower the Threads per file.

Clone this wiki locally