Bizmuth accepts command-line options — handy for scripting, launching a specific machine or media, and headless capture. Run with --help for the authoritative, up-to-date list.
Common options
Option
Purpose
--machine <kind>
Machine to emulate: 48k, 128k, plus2a, plus3, next.
--sd <img>
Attach an SD card image (Next). --sd0 / --sd1 for the two slots.
--sd-ro
Open SD images read-only (changes are kept in memory, not written back).
--nex <file>
Load a .nex (or a snapshot) after boot.
--roms-dir <dir>
Folder holding the ROMs (saved to your config; the first-run assistant sets it otherwise).
Display / speed
Option
Purpose
--max-speed <n>
Cap the CPU speed multiplier.
Capture & automation
Option
Purpose
--screenshot <file>
Run headless, save a PNG and exit.
--screenshot-frames <n>
Frames to run before the screenshot/video.
--video <file>
Run headless, record every frame as an animated PNG, and exit.