xroar - Man Page

-m name, -default-machine name

Default machine profile to select on startup.

-machine name

Create or modify named machine profile.  -machine help lists currently defined profiles.

The remaining options configure the currently selected machine:

-machine-desc text

Machine description shown in -machine help and menu options.

-machine-arch arch

Machine architecture (dragon64, dragon32, coco, coco3 or mc10)

-machine-keyboard layout

Keyboard layout (dragon, dragon200e, coco or coco3)

-machine-cpu cpu

Machine CPU (6809 or 6309).  Not applicable to the MC-10.

-bas rom

ROM image for Colour BASIC (CoCo) or Microcolour BASIC (MC-10).

-extbas rom

ROM image for Extended BASIC (Super Extended BASIC on the CoCo 3).

-altbas rom

ROM image for 64K-mode Extended BASIC (Dragon 64, Dragon 200-E).

-nobas,  -noextbas,  -noaltbas

Indicate the corresponding ROM is not fitted in this machine.

-ext-charset rom

External character generator ROM to use.

-tv-type type

TV type (pal, ntsc or pal-m).

-tv-input input

One of ‘cmp’ (composite video, no cross-colour), ‘cmp-br’ (composite video, blue-red cross-colour), ‘cmp-rb’ (composite video, red-blue cross-colour) or ‘rgb’ (RGB video, CoCo 3 only).

-vdg-type type

Indicate the VDG variant fitted. One of 6847 or 6847t1.

-ram kbytes

Amount of RAM fitted in kilobytes. Valid sizes are 4-64K for Dragon and Tandy CoCo 1/2; 128K or 512K for the Tandy CoCo 3; 2K, 4K or 20K for the Tandy MC-10.

-machine-cart name

Default cartridge to attach.

-nodos

Indicate that XRoar is not to automatically attempt to attach a DOS cartridge to this machine (the default is to try).

-cart name

Create or modify named cartridge profile.  -cart help lists currently defined profiles.

The remaining options configure the currently selected cartridge:

-cart-desc text

Cartridge description shown in -cart help and menu options.

-cart-type type

Cartridge base type (-cart-type help for list).

-cart-rom rom

ROM image to load ($C000-).

-cart-rom2 rom

Second ROM image to load ($E000-).

-cart-autorun

Autorun cartridge.

-cart-becker

Enable becker port where supported.

-mpi-slot slot

(MPI) initially select slot (0-3).

-mpi-load-cart [slot=]name

(MPI) insert cartridge into next or numbered slot.

These options also apply to the similar RACE Computer Expansion Cage.

-becker

Prefer becker-enabled DOS cartridge when picked automatically.

-becker-ip address

Address or hostname of DriveWire server [127.0.0.1]

-becker-port port

Port of DriveWire server [65504]

-load-tape file

Attach file as tape image for reading.

-tape-write file

Open file for tape writing.

-tape-pan panning

Pan stereo input (0.0 = full left, 1.0 = full right) [0.5]

-tape-hysteresis percent

Read hysteresis as percentage of full scale [1]

-no-tape-fast

Disable fast tape loading.

-no-tape-pad-auto

Disable automatic leader padding.

-tape-ao-rate hz

Set tape writing frame rate [9600]

-tape-rewrite

Enable tape rewriting.

-tape-rewrite-gap-ms ms

Gap length in milliseconds to write in rewrite mode (1-5000ms, default 500ms).

-tape-rewrite-leader bytes

Length of leaders in bytes to write in rewrite mode (1-2048 bytes, default 256).

-load-fdX file

Insert disk image file into floppy drive X (0-3).

-no-disk-write-back

Don't default to enabling write-back for disk images.

-no-disk-auto-os9

Don't try to detect headerless OS-9 JVC disk images.

-no-disk-auto-sd

Don't assume single density for 10 sec/track disks.

-load-hdX file

Use file as the hard disk image for drive X (0-1).

-load-sd file

Use file as the SD card image.

-kbd-layout layout

Host keyboard layout (-kbd-layout help for list).

-kbd-lang lang

Host keyboard language (-kbd-lang help for list).

-kbd-bind hostkey=[pre:]emukey

Map host key to emulated key (pre = no translate).

-kbd-translate

Enable keyboard translation.

-type string

Intercept ROM calls to type string into BASIC.

-load-text file

Type file into BASIC.

-joy-db-file file

Load gamepad mappings from file.

-joy-right name

Map right joystick.

-joy-left name

Map left joystick.

-joy-virtual name

Specify the 'virtual' joystick to cycle [kjoy0]

-joy name

Configure named joystick (-joy help for list).

The remaining options configure the currently selected joystick:

-joy-desc text

Joystick description.

-joy-axis axis=spec

Configure joystick axis.

-joy-button btn=spec

Configure joystick button.

-lp-file file

Append printer output to file.

-lp-pipe command

Pipe printer output to command.

-load file

Load or attach file

-run file

Load or attach file and attempt autorun

-load-fdX file

Insert disk image file into floppy drive X (0-3).

-load-hdX file

Use file as the hard disk image for drive X (0-1).

-load-sd file

Use file as the SD card image.

-load-tape file

Attach file as tape image for reading.

-tape-write file

Open file for tape writing.

-load-text file

Type file into BASIC.

-rompath path

ROM search path (colon-separated list)

-romlist name=list

define a ROM list

-romlist-print

print defined ROM lists

-crclist name=list

define a ROM CRC list

-crclist-print

print defined ROM CRC lists

-force-crc-match

force per-architecture CRC matches

-ui module

user-interface module (-ui help for list)

-vo module

video module (-vo help for list)

-fs

start emulator full-screen if possible

-fskip frames

frameskip (default: 0)

-ccr renderer

cross-colour renderer (simple, 5bit, partial or simulated)

-gl-filter filter

OpenGL texture filter (auto, nearest or linear)

-geometry wxh+x+y

initial emulator geometry

-vo-picture p

initial picture area (-vo-picture help for list)

-no-vo-scale-60hz

disable vertical scaling for 60Hz video

-invert-text

start with text mode inverted

-vo-brightness n

set TV brightness (0-100) [50]

-vo-contrast n

set TV contrast (0-100) [50]

-vo-colour n

set TV colour saturation (0-100) [50]

-vo-hue n

set TV hue control (-179 to +180) [0]

-no-vo-colour-killer

disable colour killer (enabled by default)

-ao module

audio module (-ao help for list)

-ao-device string

device to use for audio module

-ao-format fmt

set audio sample format (-ao-format help for list)

-ao-rate hz

set audio frame rate (if supported by module)

-ao-channels n

set number of audio channels, 1 or 2

-ao-fragments n

set number of audio fragments

-ao-fragment-ms ms

set audio fragment size in ms (if supported)

-ao-fragment-frames n

set audio fragment size in samples (if supported)

-ao-buffer-ms ms

set total audio buffer size in ms (if supported)

-ao-buffer-frames n

set total audio buffer size in samples (if supported)

-ao-gain db

audio gain in dB relative to 0 dBFS [-3.0]

-volume volume

older way to specify audio volume, linear (0-100)

-gdb

enable GDB target

-gdb-ip address

address of interface for GDB target [127.0.0.1]

-gdb-port port

port for GDB target to listen on [65520]

-trace

start with trace mode on

-debug-fdc flags

FDC debugging (see manual, or -1 for all)

-debug-file flags

file debugging (see manual, or -1 for all)

-debug-gdb flags

GDB target debugging (see manual, or -1 for all)

-debug-ui flags

UI debugging (see manual, or -1 for all)

-v,  --verbose level

general debug verbosity (0 to 3) [1]

-q,  --quiet

equivalent to --verbose 0

-trap condition

configure a trap to fire on condition.

The remaining options affect the configured trap:

-trap-range m-n

perform trap's action only on mth-nth trigger.

-trap-snap file

write snapshot at trap.

-trap-timeout n

quit emulator n seconds after trap.

-trap-trace

start trace mode at trap.

-trap-no-trace

stop trace mode at trap.

Older options remain that can be implemented using traps:

-timeout s

run for s seconds then quit.

-timeout-motoroff s

quit s seconds after tape motor switches off.

-snap-motoroff file

write a snapshot each time tape motor switches off.

-config-print

print configuration to standard out.

-config-print-all

print configuration to standard out, including defaults.

-h,  --help

display help and exit.

-V,  --version

output version information and exit.