Command line reference

Command Line Reference

This page lists common command-line patterns and the most used options. For the full list of options, run amiberry --help in a terminal.

Help, logging, and diagnostics

• -h, --help: Show help and exit.
• --version: Print version information and exit.
• --log: Show log output in the console.
• --rescan-roms: Force a ROM rescan on startup.
• --jit-selftest: Run the JIT compiler self-test and exit.
• --dump-paths: Print the resolved startup paths and exit. This is a dry-run diagnostic mode and does not migrate files, create directories, or rewrite settings.
• --download-whdboot: Explicitly download or refresh the WHDBooter runtime assets and exit.

Launching and configuration

• -f <file>, --config <file>: Load a configuration file.
• --model <model>: Use a Quickstart model preset. Supported: A1000, A500, A500P, A600, A2000, A3000, A1200, A4000, CD32, CDTV.
• -G: Start emulation directly without showing the GUI (also sets use_gui=no).
• -s <option>=<value>: Set one or more emulator options directly, without loading a file.
• -cfgparam <option>=<value>: Alternative to -s. Also supports -cfgparam=<option>=<value>.
• -o <amiberry_conf>=<value>: Set an amiberry.conf parameter. See amiberry.conf options.

Media loading

• amiberry <file>: Auto-detect the file type and use the default action. Supported: .uae config files, .lha WHDLoad archives, CD images (.cue, .iso, .chd), disk images (.adf, .adz, .dms, .ipf, .zip), and save states (.uss). For floppy disk images, Amiberry also checks if a matching .uae config file exists and loads it automatically.
• --autoload <file>: Load a WHDLoad .lha archive or a CD image (.cue, .iso, .chd) using the WHDBooter.
• --cdimage <file>: Load a CD image on startup.
• --statefile <file>: Load a save state file. If the file is not found at the given path, Amiberry also checks the configured savestates directory.

Console emulation

• -cli [path], --cli [path]: Enable console emulation mode. Optionally provide a path. Also supports --cli=<path>.

Floppy drives and disks

• -0 <disk.adf>: Insert ADF into drive 0.
• -1 <disk.adf>: Insert ADF into drive 1.
• -2 <disk.adf>: Insert ADF into drive 2.
• -3 <disk.adf>: Insert ADF into drive 3.
• -diskswapper=d1.adf,d2.adf: Preload a comma-separated list of disk images into the Disk Swapper. Use quotes for paths containing commas: -diskswapper="path with,comma/d1.adf",d2.adf.

ROMs and storage

• -r <kick.rom>: Load main ROM from a path.
• -K <kick.rom>: Load extended ROM from a path.
• -m VOLNAME:mount_point: Attach a volume to a mount point.
• -W DEVNAME:hardfile: Attach a hardfile with a device name.

CPU, chipset, and memory

• -w <value>: CPU emulation speed. 0 = Cycle Exact, -1 = Max.
• -C <value>: Set CPU specs (e.g. 0 for 68000, 2 for 68020). Optional suffixes: a = 24-bit address space, c = compatible mode (68000 only).
• -v <value>: Set chipset. 0=OCS, 1=ECS Agnus, 2=ECS Denise, 3=Full ECS, 4=AGA.
• -c <value>: Chip RAM size (512KB units).
• -F <value>: Fast RAM size (1MB units).
• -b <value>: Bogomem size (256KB units).
• -Z <value>: Z3 Fast RAM size (1MB units).
• -U <value>: RTG memory size (1MB units).
• -i: Enable illegal memory.
• -n: Enable Immediate Blits (only when illegal memory is not enabled).

Graphics, audio, and input

• -O <value>: Set graphics specs. Format: width:height:modifiers. Modifiers: l = line doubling, x/X = horizontal centering, y/Y = vertical centering, d/D = double vertical resolution, a = fullscreen amiga, p = fullscreen picasso.
• -H <value>: Color mode.
• -S <value>: Sound parameter specification.
• -R <value>: Output framerate in FPS.
• -l <value>: Keyboard layout language (de, dk, us, se, fr, it, es).
• -J <xy>: Specify joystick 0 (x) and 1 (y). Values: 0/1 for joystick, M for mouse, and a/b/c.

Serial and parallel

• -p <printer>: Set the printer device name.
• -d <value>: Serial/parallel on demand. Include S or s for serial on demand, P or p for parallel on demand.

Debugging

• -D: Start the built-in debugger (when Amiberry is compiled with debugger support).

Examples

Load a configuration

amiberry --config /path/to/some-name.uae

Load a configuration and a save state

amiberry --config /path/to/some-name.uae --statefile /path/to/some-name.uss -s use_gui=no

The following shorthand is also supported:

amiberry --config some-name.uae --statefile some-name.uss -G

Load a save state directly

amiberry some-name.uss

You can also load a save state and keep the GUI open:

amiberry --statefile some-name.uss

See Savestates for more details about save state usage and limitations.

Use a Quickstart model preset

amiberry --model A1200 -G

This will use the A1200 default settings and enter emulation directly.

Auto-load a WHDLoad game

amiberry lha/MyGame.lha

This will load the WHDLoad game using the autoload mechanism.

Load a config with additional overrides

amiberry --config conf/A500.uae --statefile savestates/game.uss -s use_gui=no