MiSTer

These commands target MiSTer. On unsupported platforms, the command returns an error and the rest of the script stops. To boot an alternate core without loading a game, use launch.system with ?launcher=.

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.

Examples

Load the first ini file:

**mister.ini:1

Load the second ini file:

**mister.ini:2

Info

The ini switch does not persist after a reboot, matching MiSTer's OSD behavior. If the menu core is open, it will be relaunched after the switch.

---

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 end of the filename, such as a date suffix, can be omitted.

Examples

Launch the SNES core:

**mister.core:_Console/SNES

Launch a specific PSX core version:

**mister.core:_Console/PSX_20220518

Launch the ao486 core:

**mister.core:_Computer/ao486

---

mister.script

Launches a MiSTer script from the Scripts folder.

Platform Support

This command is supported on MiSTer only.

Syntax

**mister.script:<script>

Arguments

script (required) The script filename (must exist directly in /media/fat/Scripts; names containing path separators are rejected). 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
launch_origin_id	string	none	A value passed to the script as the LAUNCH_ORIGIN_ID environment variable, so it can tell what launched it

Examples

Run the Update All script on screen:

**mister.script:update_all.sh

Run the script in the background:

**mister.script:update_all.sh?hidden=true

Run a script with arguments:

**mister.script:my_script.sh arg1 arg2

Info

Without hidden, the current game closes and the script runs on screen as if launched from the Scripts menu.

---

mister.mgl

Launches MGL (MiSTer Game Library) content from inline XML.

Syntax

**mister.mgl:<content>

Arguments

content (required) The MGL XML content as a string. A temporary MGL file is created and launched.

Examples

Create and launch an MGL to run Sonic on the Genesis core:

**mister.mgl:<setname>Genesis</setname><rbf>_Console/Genesis</rbf><file delay="1" type="f" index="0" path="../games/Genesis/Sonic.md"/>

Info

Use this when you need to build MGL content in ZapScript instead of keeping a separate .mgl file on disk.

---

mister.wallpaper

Sets or unsets the MiSTer main menu wallpaper. When setting a wallpaper, the image is loaded from /media/fat/wallpapers/. If MiSTer is on the main menu, the wallpaper is refreshed immediately.

Syntax

**mister.wallpaper:<filename>

**mister.wallpaper

Arguments

filename (optional) The wallpaper image filename (e.g., background.png). Supports .png and .jpg files. The file must exist in /media/fat/wallpapers/. If omitted, the current wallpaper is unset.

Examples

Set the menu wallpaper to retro_bg.png:

**mister.wallpaper:retro_bg.png

Remove the current wallpaper and revert to random selection:

**mister.wallpaper