XROAR(1)

NAME
xroar - Dragon and Tandy CoCo 1/2 emulator

SYNOPSIS
xroar [-c conffile] [OPTION]... [FILENAME]...

DESCRIPTION
xroar is a Dragon emulator that runs on a wide variety of platforms. Due to hardware similarities, XRoar also emulates the Tandy Colour Computer (CoCo) models 1 & 2.

OPTIONS
Options are first read from a configuration file (by default, $HOME/.xroar/xroar.conf). Options on the command line override any found in the configuration file.

-c conffile
    specify a configuration file

  Machines:

-default-machine name
    default machine on startup

-machine name
    configure named machine (-machine help for list)

The remaining options configure the currently selected machine:

-machine-desc text
    machine description

-machine-arch arch
    machine architecture (dragon64, dragon32 or coco)

-machine-keyboard layout
    keyboard layout (dragon, dragon200e or coco)

-machine-cpu cpu
    machine CPU (6809 or 6309)

-bas name
    BASIC ROM to use (CoCo only)

-extbas name
    Extended BASIC ROM to use

-altbas name
    64K mode Extended BASIC ROM (Dragon 64)

-nobas
    disable BASIC

-noextbas
    disable Extended BASIC

-noaltbas
    disable 64K mode Extended BASIC

-ext-charset name
    external character generator ROM to use

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

-vdg-type type
    VDG type (6847 or 6847t1)

-ram kbytes
    amount of RAM in K

-machine-cart name
    default cartridge for selected machine

-nodos
    don't automatically pick a DOS cartridge

  Cartridges:

-cart name
    configure named cartridge (-cart help for list)

The remaining options configure the currently selected cartridge:

-cart-desc text
    cartridge description

-cart-type type
    cartridge base type (-cart-type help for list)

-cart-rom name
    ROM image to load ($C000-)

-cart-rom2 name
    second ROM image to load ($E000-)

-cart-autorun
    autorun cartridge

-cart-becker
    enable becker port where supported

  Multi-Pak Interface:

-mpi-slot slot
    initially select slot (0-3)

-mpi-load-cart [slot=]name
    insert cartridge into next or numbered slot

  Becker port:

-becker
    prefer becker-enabled DOS (when picked automatically)

-becker-ip address
    address or hostname of DriveWire server [127.0.0.1]

-becker-port port
    port of DriveWire server [65504]

  Files:

-load file
    load or attach file

-run file
    load or attach file and attempt autorun

  Cassettes:

-tape-write file
    open file for tape writing

-tape-channel-mode mode
    select stereo input channel (mix, left, right)

-no-tape-fast
    disable fast tape loading

-tape-pad
    force tape leader padding

-no-tape-pad-auto
    disable automatic leader padding

-tape-rewrite
    enable tape rewriting

-tape-ao-rate hz
    set tape writing frame rate

  Disks:

-disk-write-back
    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

  Firmware ROM images:

-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

  User interface:

-ui module
    user-interface module (-ui help for list)

  Video:

-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 or simulated)

-gl-filter filter
    OpenGL texture filter (auto, nearest or linear)

-geometry wxh+x+y
    initial emulator geometry

-invert-text
    start with text mode inverted

  Audio:

-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)

-fast-sound
    faster but less accurate sound

  Keyboard:

-keymap code
    host keyboard type (-keymap help for list)

-kbd-translate
    enable keyboard translation

-type string
    intercept ROM calls to type string into BASIC

  Joysticks:

-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

  Printing:

-lp-file file
    append printer output to file

-lp-pipe command
    pipe printer output to command

  Debugging:

-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-ui flags
    UI debugging (see manual, or -1 for all)

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

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

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

-v, --verbose level
    general debug verbosity (0 to 3) [1]

-q, --quiet
    equivalent to --verbose 0

-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

  Other options:

-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

FILES
$HOME/.xroar/xroar.conf

AUTHOR
Ciaran Anscomb <xroar@6809.org.uk>