Best-fit scenarios
Use this when you want Tater to browse or control a MiSTer setup from chat, voice, or the WebUI without dealing with the MiSTer Remote API directly.
Verba profile
MiSTer Remote
Control your MiSTer FPGA setup—launch games, check status, or take screenshots.
mister_remote
Version 1.1.8
Execution guidance
Set MISTER_HOST and MISTER_PORT in plugin settings, make sure MiSTer Remote and Search are installed on the MiSTer, then send one natural-language request in query such as play super mario on super nintendo or what is playing on mister.
Input shape
-
query
string
play super mario on super nintendo
Required configuration
This Verba does not declare plugin-specific settings in its metadata. Any dependencies are handled through portal config, environment variables, or the backing service itself.
Usage guide
How this plugin fits real-world workflows.
These notes focus on the setup, calling pattern, and runtime behavior that matter most for this plugin.
mrextPort 8182Search index
Quick setup on MiSTer
MiSTer Remote depends on the mrext Remote and Search tools running on the MiSTer box.
- Install the MiSTer Remote and Search scripts from the mrext release bundle and place them under /media/fat/Scripts on the MiSTer.
- Run Search at least once so the game database exists before Tater tries to launch titles by search.
- Start remote.sh and confirm the Remote UI is reachable from the Tater machine, usually at http://YOUR_MISTER_IP:8182.
MISTER_HOSTMISTER_PORTReachability
Tater plugin settings
Tater only needs the MiSTer host and port, but the Remote index must already be healthy.
- Set MISTER_HOST to the MiSTer Remote host URL and MISTER_PORT to the API port if you changed it from 8182.
- If MiSTer Remote can see your library and search it, Tater can search and launch it too, including CIFS-backed libraries that are already indexed.
- If launch lookups fail or the library seems empty, rebuild the MiSTer Search index first before troubleshooting Tater.
playnow_playinggo_to_menuscreenshot_take
Supported commands
The plugin maps natural language into four main MiSTer actions.
- play launches the closest matching game on the chosen or inferred system, for example play mario on snes.
- now_playing reports the current game and system, go_to_menu returns to the MiSTer menu, and screenshot_take captures a screenshot artifact.
- The screenshot action returns image payload data when available so the current portal can display or attach the screenshot cleanly.
gamesdbNo systemsReindex
Troubleshooting
Most setup failures come down to reachability or a missing search database.
- If you see behavior like gamesdb does not exist or no systems are found, run Search once and refresh the MiSTer Remote index.
- If Tater cannot talk to MiSTer at all, double-check MISTER_HOST and MISTER_PORT in plugin settings and verify the Remote web UI is reachable from the Tater box.
- Natural-language launch requests work best after the Search index is current, because Tater relies on MiSTer Remote search results to pick the right game path.
Canonical usage JSON
{
"function": "mister_remote",
"arguments": {
"query": "play super mario on super nintendo"
}
}