Degauss

Game libraries and ZIP archives

Degauss follows MiSTer’s existing folders across SD, USB and network storage, then keeps a compact index of what the card already contains.

External storage

Games on a USB stick, network share or CIFS mount are found without setup, in the same order MiSTer’s loader searches: /media/usb0 through usb5, then /media/network, /media/fat/cifs, and finally the card, each under its games folder.

For each system folder, the first location containing it wins. Different folders for one system can resolve to different locations. Storage is detected when Degauss starts, so connect it before starting Degauss or restart afterwards.

Moving a system between storage locations changes its paths. Rebuild that system or run a full rebuild afterwards. Layouts outside the defaults can be set with one game_roots edit in degauss.toml.

Index and rebuild a library

The first run reads the card and writes an index. Ordinary folder libraries then reuse their saved lists. After adding games, use Options → Library → Rebuild All System Lists. To read only one system, use X Actions → Library → Rebuild This System List from anywhere inside it.

A successful rebuild reflects additions and removals. If a folder or archive cannot be read, Degauss reports the error and keeps that system’s previous complete list.

Rebuilds show the active system and folder, processed systems, folder and game counts, and elapsed time. A Details opens the full report. B Cancel requests cancellation while a rebuild is active. Input and repaint remain responsive, and the screensaver stays off during indexing.

ZIP libraries

ZIP archives open as folders, including internal subfolders, without extracting the library. Systems that already launch ZIP files as individual games keep that behaviour.

ZIP64 is supported within the documented bounds. Metadata for a multi-game archive identifies each game by its full archive and member path. Single-game archives retain legacy archive-level metadata.

See the repository’s ZIP library documentation for the detailed bounds and launch limits.