Utilities

These commands stop media, log messages, run host commands, add delays, send launcher controls, and take screenshots.

stop

Stops the currently running media and returns to the menu.

Syntax

**stop

Arguments

None.

Advanced Arguments

Argument	Type	Default	Description
when	expression	-	Conditional execution (see Expressions)

Examples

Stop whatever is currently playing and return to the menu:

**stop

Only stop if media is currently playing:

**stop?when=[[media_playing]]

---

echo

Outputs a message to the Zaparoo Core log file.

Syntax

**echo:<message>

Arguments

message (required) The text to output. Multiple arguments are joined with , and logged at "info" level.

Advanced Arguments

Argument	Type	Default	Description
when	expression	-	Conditional execution (see Expressions)

Examples

Log "Token was scanned" to the Core log file:

**echo:Token was scanned

Log the current platform using an expression:

**echo:Platform is [[platform]]

---

execute

Runs a command on the host system.

Syntax

**execute:<command>

Arguments

command (required) The command to run, including any arguments. Arguments are split while respecting double and single quoted strings. The command is executed directly without a shell interpreter, so shell features like pipes, redirection, or command substitution are not supported. The command has a 2-second timeout.

Advanced Arguments

Argument	Type	Default	Description
when	expression	-	Conditional execution (see Expressions)

Examples

Reboot the system:

**execute:reboot

Send a desktop notification on Linux systems with notify-send:

**execute:notify-send "Game started"

Security Requirement

This command requires explicitly enabling the arguments in the allow_execute config option. It is always blocked from remote sources. Currently, Zap Links are the only remote source; scripts sent through the Zaparoo App are checked against allow_execute normally.

---

delay

Pauses script execution for a specified duration.

Syntax

**delay:<milliseconds>

Arguments

milliseconds (required) The number of milliseconds to pause. Must be an integer.

Advanced Arguments

Argument	Type	Default	Description
when	expression	-	Conditional execution (see Expressions)

Examples

Pause for 500 milliseconds, or half a second:

**delay:500

Pause for 10 seconds:

**delay:10000

Launch SNES, wait 10 seconds, then press F12:

_Console/SNES||**delay:10000||**input.keyboard:{f12}

Blocking Command

This is a blocking command. The entire script pauses until the delay completes.

---

control

Dispatches a launcher control action to the active media's launcher. This allows you to send commands to whatever is currently playing, such as pausing, saving state, or skipping tracks.

Syntax

**control:<action>

Arguments

action (required) The control action to dispatch. Available actions depend on the launcher handling the currently active media.

Defined action names include:

• toggle_pause - Pause or unpause
• save_state - Save the current state
• load_state - Load a saved state
• save_ram - Save RAM data
• toggle_menu - Toggle an in-game menu
• reset - Reset the active media
• stop - Stop the active media
• fast_forward - Fast forward
• rewind - Rewind
• next - Skip to next
• previous - Go to previous

Advanced Arguments

Argument	Type	Default	Description
when	expression	-	Conditional execution (see Expressions)

Examples

Pause or unpause the currently playing media:

**control:toggle_pause

Save the current state, such as a save state in an emulator:

**control:save_state

info

Media must be actively playing for this command to work. If no media is active, the command will return an error. The available actions depend on the launcher, and not all launchers support all actions.

---

screenshot

Captures the current platform display and saves the screenshot to disk.

Platform Support

Currently supported on MiSTer and RePlayOS.

Syntax

**screenshot

Arguments

None.

Advanced Arguments

Argument	Type	Default	Description
when	expression	-	Conditional execution (see Expressions)

Examples

Capture a screenshot of the current display:

**screenshot