Skip to main content
Version: Stable

MiSTeX

MiSTeX is fully supported by Zaparoo and closely follows MiSTer. The main differences are installation and the current reader set.

File paths​

ItemPath
Config file/media/fat/zaparoo/config.toml
Data directory/media/fat/zaparoo
Log file/tmp/zaparoo/core.log
Mappings directory/media/fat/zaparoo/mappings

The /media/fat directory is the top level of the SD card. The /tmp directory is deleted when MiSTeX is powered off, so Core copies the log to /media/fat/zaparoo/core.log when it shuts down cleanly, and when it stops on a startup problem that needs your attention.

Install​

Download Zaparoo Core for MiSTeX from the GitHub releases page and copy the zaparoo.sh file to the Scripts folder on your SD card.

Run zaparoo from the MiSTeX Scripts menu. A prompt will offer to enable Zaparoo as a startup service. With the service running, write your first token from the Zaparoo App or the built-in web UI at http://<mistex-ip>:7497/app/.

Warning

Using FileZilla? Enable binary transfer mode per these steps. FileZilla incorrectly detects zaparoo.sh as text and will corrupt it.

Readers​

TypeReaderSupportSetupNotes
NFC/RFIDPN532 USBSupportedAuto-detected
NFC/RFIDPN532 ModuleSupportedDepends on wiringUART can auto-detect. I2C is supported.
NFC/RFIDACR122ULimitedManual enableUses libnfc: MIFARE Classic writing is limited, LED and beeper do not work, and some clone variants are incompatible.
NFC/RFIDRC522LimitedVia Simple SerialRequires a microcontroller; not a direct USB reader.
Barcode and QRZaparoo App cameraSupportedVia Zaparoo App
Barcode and QRRS-232 scannerSupportedManual config
Optical and MediaOptical DriveNot supportedNot availableNot included in the current MiSTeX Core reader set.
Optical and MediaExternal DriveSupportedManual enable
Custom and VirtualMQTT ReaderSupportedManual config
Custom and VirtualSimple SerialSupportedManual config
Custom and VirtualFile ReaderSupportedManual config
Displays and IntegrationsTTY2OLEDSupportedManual enable

Each reader's page has setup steps and troubleshooting. See readers to compare them, or the setup guide to pick one for your setup.

Launchers​

All launchers supported by MiSTer are also supported by MiSTeX (as far as MiSTeX itself supports them):

LauncherNotes
FPGA Cores100+ arcade, console, and computer systems
MGL FilesMiSTer Game Loader format
Shell ScriptsCustom .sh file execution

See MiSTer Launchers for the full list of supported systems.