MiSTer
These commands are only available on the MiSTer platform. They will be ignored on other platforms.
mister.ini
Loads a MiSTer.ini configuration file.
Syntax
**mister.ini:<index>
Arguments
index (required)
The ini file index (1 to 4) as shown in the MiSTer menu.
Advanced Arguments
| Argument | Type | Default | Description |
|---|---|---|---|
when | expression | - | Conditional execution (see Expressions) |
Examples
**mister.ini:1
Loads the first ini file.
**mister.ini:2
Loads the second ini file.
The ini switch does not persist after a reboot, same as loading through the OSD. The menu core will be relaunched if currently open.
mister.core
Launches a MiSTer core .rbf file directly.
Syntax
**mister.core:<path>
Arguments
path (required)
Path to the core, relative to the SD card root. Uses the same format as the rbf tag in MGL files - the filename ending can be omitted.
Advanced Arguments
| Argument | Type | Default | Description |
|---|---|---|---|
when | expression | - | Conditional execution (see Expressions) |
Examples
**mister.core:_Console/SNES
Launches the SNES core (any version).
**mister.core:_Console/PSX_20220518
Launches a specific PSX core version.
**mister.core:_Computer/ao486
Launches the ao486 core.
mister.script
Launches a MiSTer script from the Scripts folder.
Syntax
**mister.script:<script>
Arguments
script (required)
The script filename (must exist in /media/fat/Scripts). Arguments can be included after the filename.
Advanced Arguments
| Argument | Type | Default | Description |
|---|---|---|---|
hidden | boolean | false | Run the script in the background without displaying on screen |
when | expression | - | Conditional execution (see Expressions) |
Examples
**mister.script:update_all.sh
Runs the Update All script on screen.
**mister.script:update_all.sh?hidden=yes
Runs the script in the background without interrupting the current game.
**mister.script:my_script.sh arg1 arg2
Runs a script with arguments.
When not using hidden, the currently running game will be closed and the script runs on screen as if launched from the Scripts menu.
mister.mgl
Executes MGL (MiSTer Game Library) content directly without a file.
Syntax
**mister.mgl:<content>
Arguments
content (required)
The MGL XML content as a string. A temporary MGL file is created and launched.
Advanced Arguments
| Argument | Type | Default | Description |
|---|---|---|---|
when | expression | - | Conditional execution (see Expressions) |
Examples
**mister.mgl:<setname>Genesis</setname><rbf>_Console/Genesis</rbf><file delay="1" type="f" index="0" path="../games/Genesis/Sonic.md"/>
Creates and launches an MGL to run Sonic on the Genesis core.
This allows programmatically creating MGL content without storing files on disk.