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 and logging

• -h, --help: Show help and exit.
• --log: Show log output in the console.

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.
• -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, .lha, CD images, disk images.
• --autoload <file>: Load a WHDLoad .lha or CD32 CD image using the WHDBooter.
• --cdimage <file>: Load a CD image on startup.
• --statefile <file>: Load a save state file.

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.

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.
• -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 disabled).

Graphics, audio, and input

• -O <value>: Set graphics specs.
• -H <value>: Color mode.
• -S <value>: Sound parameter specification.
• -R <value>: Output framerate in FPS.
• -I <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.

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

In newer versions of Amiberry, 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.