Start here. Every MiSTer (or just host): its model, what it's playing, and what works on it right now.

capabilities names what works (search, launch, screenshot, ini_write, backup_saves, ...); limitations says what doesn't and how to fix it, e.g. Zaparoo Core not installed, or SSH not set up. core is the running MiSTer core (MENU in the menu) and attract_mode is true while MiSTer Super Attract Mode cycles games; both need SSH. dry_run true means this server reports writes instead of doing them.

The systems each MiSTer can launch (consoles, computers, arcade), with how many games each has indexed and the MiSTer core that runs it. Use a system's id with search_games, or launch(system=...) to open the core with no game (e.g. a computer core).

Find games in each MiSTer's Zaparoo library by name (every word must match), optionally in one system.

Each result has a ref for launch. The same game on two MiSTers comes back twice, with two refs: the ref says which TV it launches on. variant tells apart files with the same name (region, revision, hack).

What's been played on each MiSTer, from Zaparoo's own records: games launched from the MiSTer's menu count too. Rows have a ref, so 'play the last thing again' is one launch call.

Read a MiSTer's MiSTer.ini (or an alternate ini), parsed into sections the way MiSTer reads it. [MiSTer] is global; [SNES] and other core-named sections override it for that core. Needs SSH.

A MiSTer's NFC readers, the card-to-game mappings Zaparoo has, and the last card scanned (its UID is what map_nfc_card uses by default).

Launch a game (by ref) or open a system's core (by id) and wait until the MiSTer reports it running.

Refuses while anything is running on that MiSTer: ending a game loses unsaved progress, so that's return_to_menu's job, and you should ask first. Rapid repeated launches are rate-limited.

End whatever is running and go back to the MiSTer menu. Unsaved progress in the game is lost, so confirm with the user first. Without host, acts on the one MiSTer that's running something.

Capture what a MiSTer is showing, as an image. MiSTer also saves it under /media/fat/screenshots. Without host, uses the one MiSTer that's running something.

Set (or remove) one MiSTer.ini setting, globally or for one core, keeping the rest of the file as it is.

The previous file is saved next to it first (MiSTer.ini..bak). The change takes effect the next time a core loads. A few keys are refused (main, bootcore, shared_folder, debug; see misterfpga://ini-keys). Needs SSH.

Copy a MiSTer's saves and save states into a new dated snapshot in the configured backup folder.

Files unchanged since the last snapshot are hard-linked rather than downloaded, so each snapshot is complete but only changes cost space. The MiSTer is only read. Old snapshots beyond the configured number are removed. Needs SSH and a backup folder (backup_dir).

Start Update All on a MiSTer's own screen (cores, Main, Linux, and whatever else it's set to update).

It runs for several minutes and the MiSTer may reboot at the end. Refuses while a game is running. Limited to once an hour per MiSTer.

Write a game onto the NFC card sitting on the reader attached to the game's MiSTer, so tapping it launches the game. Overwrites whatever the card held. Ask the user to place the card first; the call waits up to a minute for it.

Make a card launch a game without writing to it: Zaparoo remembers 'this card's UID means this game'. Works with read-only cards and toys. Ask the user to scan the card on the game's MiSTer first, then call this without uid. Refuses a card that's already mapped.