Skip to main content
This is unreleased documentation for the next Zaparoo Core release.
For up-to-date documentation, see the latest version (Stable).
Version: Next

Zaparoo Documentation

Zaparoo launches games and media when you scan a token (an NFC card, a toy, a QR code, a disc) on a reader connected to a device running Zaparoo Core. The free Zaparoo App writes tokens and manages settings from your phone. Terms you don't recognize are in the glossary.

New here? Use the setup guide. Know what you want to do? Try common tasks. Otherwise, browse the sections below.

Setup guideCommon tasksSearch documentation

Hardware and setup

Platforms

Install Zaparoo on MiSTer, Windows, SteamOS, Batocera, Linux, and more.

Readers

Choose and configure NFC, barcode, cartridge, optical, and virtual readers.

Tokens

Create NFC cards, QR codes, barcodes, toys, and removable-drive tokens.

ZapESP32

Build and configure a wireless DIY NFC reader with an ESP32.

Zaparoo Shop

Tested readers, cards, and starter kits. Purchases fund development.

Apps and services

Zaparoo App

Connect to Core, scan tokens, write NFC tags, and manage your device from iOS or Android.

Zaparoo Frontend

Browse and launch your MiSTer media library from a TV-friendly interface.

Zaparoo Online

Free play history sync, virtual cards and decks, and the User API. Warp adds paid cloud backup.

Customize and automate

Zaparoo Core

Configure the service that reads tokens, launches media, and powers Zaparoo clients.

Features

Set up mappings, profiles, playlists, backups, play controls, and custom launchers.

ZapScript

Control what happens when a token is scanned, from launches to custom actions.

Design and community

Zaparoo Designer

Create custom card label artwork in your browser.

Labels

Choose templates, print artwork, and apply labels to your cards.

Community Projects

Browse DIY readers, 3D prints, and community-built tools.

Community

Discord, Reddit, YouTube, vendors, contributors, and press coverage.

Help

Something not working?

Where to ask, how to collect logs, and what to include in a report.

Glossary

Token, reader, Core, mapping, UID, NDEF, and the other terms used in these docs.