Zaparoo Frontend is the game frontend for Zaparoo Core.
Start with docs/building.md. It covers the packages you need on a fresh machine and the MiSTer cross-build path.
Most commands go through the justfile. Run just --list if you
need the full menu.
just build && just run # desktop
./scripts/build-arm32.sh # MiSTer ARM32 cross-build (Docker-only)
just test # ctest + cargo nextest
just lint # clang-format, clang-tidy, qmllint, rustfmt, clippy, cargo-denyThe MiSTer ARM32 path uses the official Docker Buildx toolchain image and does
not need Qt, CMake, Rust, or just installed on the host.
You can override system artwork, the Hub menu icons, and system display names without rebuilding. See docs/customization.md.
just test and just lint need cargo-nextest and cargo-deny:
cargo install --locked cargo-nextest cargo-denyThis repository includes Zaparoo trademarks used here with permission from the trademark owner. If you redistribute or adapt the project, remove or replace those marks first. See the Zaparoo Terms of Use for the details.
Copyright 2026 Wizzo Pty Ltd and the Zaparoo Project contributors. Source available under the PolyForm Noncommercial License 1.0.0. Non-commercial use only. For commercial licensing, contact legal@zaparoo.org.
Third-party components:
- Qt framework: LGPLv3. Dynamically linked on desktop builds; statically
linked on MiSTer ARM32. Object files for re-linking against a modified Qt
are available on request at
legal@zaparoo.org.
See
src/LICENSES/Qt-LGPL-NOTICE.txtandsrc/LICENSES/LGPLv3.txt. - zaparoo-update: optional third-party update integration, separately owned
and licensed under PolyForm Noncommercial License 1.0.0. Commercial licenses
for Zaparoo Frontend do not grant commercial rights to zaparoo-update;
commercial use, distribution, or bundling with the update integration enabled
requires a separate license from the zaparoo-update copyright holder,
José Manuel Barroso Galindo theypsilon@gmail.com. See
src/LICENSES/zaparoo-update-NOTICE.txt. - Noto Sans fonts: SIL Open Font License 1.1, © The Noto Project Authors.
See
src/LICENSES/NotoSans-ATTRIBUTION.txtandsrc/LICENSES/NotoSans-OFL.txt. - MxPlus HP 100LX 6x8 font: Creative Commons Attribution-ShareAlike 4.0
International, © VileR. See
src/LICENSES/MxPlus-ATTRIBUTION.txt. - Iconoir UI icons: MIT License, © Luca Burgio and contributors.
See
src/LICENSES/Iconoir-ATTRIBUTION.txt. - Lucide UI icons: ISC License, © 2024 Lucide Contributors (fork of Feather
Icons by Cole Bemis). See
src/LICENSES/Lucide-ATTRIBUTION.txt. - Streamline Core line icon (Handheld category): © Webalys LLC, used
under the Streamline Free License — https://streamlinehq.com. See
src/LICENSES/Streamline-ATTRIBUTION.txt. - Controller Input Icons by ElDuderino, released into the public domain.
See
src/LICENSES/controller-icons-ATTRIBUTION.txt. - Console logos redrawn by Dan Patrick (MIT-licensed compilation; platform
marks remain trademarks of their respective owners). See
src/LICENSES/console-logos-ATTRIBUTION.txt. - Wikimedia Commons public-domain text/logo assets used for specific
missing system logos. See
src/LICENSES/wikimedia-public-domain-ATTRIBUTION.txt. - Noun Project icons used in 2-player system logo composites. See
src/LICENSES/NounProject-ATTRIBUTION.txt.
See all bundled asset and third-party notices in src/LICENSES/.