### Command Line Option Summary

Option | Effect
--- | ---
Hardware Selection
-m1 | Emulate Model I
-mj | Emulate Japanese Model I
-m2 | Emulate Model II
-m3 | Emulate Model III (default)
-m3n | Emulate Norcom Model III clone that fit in a Model I case
-m4 | Emulate Model 4 (same as -m4a)
-m4a | Emulate Model 4 with 2 wait states per instruction
-m4b | Emulate Model 4 with 1 wait state per instruction
-m4c | Emulate Model 4 with no wait states per instruction
-m4ga | Emulate Model 4 Gate Array
-m4p | Emulate Model 4P
-m4d | Emulate Model 4D
-m4ss | Emulate Model 4 Student Station
-m12 | Emulate Model 12
-m16 | Emulate Model 16
-m6000 | Emulate Model 6000
-m10 | Emulate Tandy 10
-mc10 | Emulate Micro Color Computer Model MC-10
-mc | Emulate Color Computer
-mdt1 | Emulate DT-1 Terminal
-mgt | Emulate Green Thumb
-mv | Emulate Videotex Terminal
-mec | Emulate Electric Crayon
-mx70 | Act like MX-70 Printer
-l1 | Run Level I BASIC ROM (Model I or III)
-l2 | Run Level II BASIC ROM (default) (Model I or III)
-rN | Use ROM revision N (-r0, -r1, -r2, ...)
-nlc | No lowercase for Model I
-lld | Load Model I lowercase driver from cassette on startup
-nld | Do not load Model I lowercase driver from cassette
-nsc | Do not try to set the clock for the boot OS
-alt | Use alternate character set
-charrom file | Use character generator ROM from file (or :gendon)
-50 | Set frame rate to 50 Hz
-gX | Hires graphics: -g0 none, -gt Tandy (default), -gg Grafyx, -gc Grafyx clone
| -gtp for Tandy with fixed PROMs for Model 2,3,12,16,6000.
| -gl for Model 1 Lowe Electronics 18
-ddTYPE | Select Model I floppy doubler: -ddx none, -ddp Percom,
| -ddr Radio Shack, -ddrp RS+Percom, -ddd detect at boot)
-dx | Disable floppy disk controller (boot into ROM BASIC).
-dNss | Set drive N (0,1,2,3) single-sided only.
-dNds | Set drive N (0,1,2,3) double-sided only.
-dNas | Set drive N (0,1,2,3) to automatically act as single or double-sided.
-hx | Disable hard drive controller
-mem n | Emulate n KB of RAM
-mem type:n | Emulate n KB of hyper/super/mega expansion RAM.
-mem16 n | Emulate n KB of 68000 RAM
-memgap16 b n | Unmap an n KB gap in 68000 RAM starting at KB b
-mmu16 bits | Set number of extension bits in 68000 MMU (default 3)
-z180 | Use Z-180 as main CPU (Model 2) with XLR8er support (Model 4)
-mhz16 n | Run 68000 at n MHz (default 8)
-rom file | Use ROM image from file
-rom1 file | Map ROM image from file to $3000 (Model 1 only)
-aft | Aculab floppy tape (Model I only)
-80-grafix | 80-Grafix hires character generator (Model I only)
-80-grafix+ | 80-Grafix+ hires character generator (Model I only)
-pcg-80 | PCG-80 hires character generator (Model I only)
-80-grafix3 | 80-Grafix3 hires character generator (Model III only)
-omikron | Omikron Mapper for Model I (for Omikron CP/M)
-omikron-a | Omikron Mapper using version A ROM
-pakx | Disable CoCo multipak (allow only one ROM/device)
-pakswitch n | Set multipak selected slot position to N (1,2,3,4)
Program/Media Selection
-c file.cas | Insert cassette file.cas
-w file.tape | Insert floppy tape wafer file.tape into next free drive
-dN file.dsk | Insert disk into drive N (0,1,2,3 or A,B)
-d file.dsk | Insert disk into next free drive
-d dmk | Insert unformatted disk into next free drive (.dmk format)
| (add -ds for double-sided and #N for tracks)
-d imd | Insert unformatted disk into next free drive (.imd format)
-d :name | Insert internal diskette ":name" into next free drive
-td | Boot TRS-DOS (default)
-ld | Boot LDOS or LS-DOS
-ad | Boot ADOS (Tandy 10 only)
-d0 - | Don't insert TRS-DOS or other boot disk (or -dA -)
-h file.hdv | Attach hard drive to next free slot
-hN file.hdv | Attach hard drive to slot N
-cs -csx | Enable/disable cassette auto save
-csd N | Set cassette auto-save delay in 1/10ths of a second.
-cix | Disable cassette I/O is happening/CMD"T" warning.
file.dsk | Insert disk into next free drive (also .dmk, .imd)
file.tape | Insert floppy tape wafer into next free drive
file.ccc | Insert Colour Computer Program Pak ROM (CoCo only)
-pak file | Insert Colour Computer Program Pak (cartridge) ROM from file
| into next free slot
-pakq file | As -pak but Program Pak won't auto start
-pak :name | Insert FDC (:fdc) or HDC (:hdc) into free slot
-pakdev :name file
| Insert device :name using ROM from file
:name | Insert internal diskette or wafer into next free drive
file | One or more files to load and execute after auto-boot
| .cmd files are run from dos prompt
| .cas, .bas and .bds files are loaded into ROM BASIC
| Files starting with #! are command scripts
Serial Port (RS-232) Options
-rx | Disable RS-232
-r host:port | Connect serial port to TCP/IP host, port endpoint.
-r @port | Listen for TCP/IP connections on port for serial line.
| (also -rB for second and -rA for first serial port)
-r :mouse | Emulate 2 button mouse on serial port
-r :mouse3 | Emulate 3 button mouse on serial port
-r :dt1 | Run DT-1 emulator attached to serial port.
-r :gt | Run Green Thumb emulator attached to serial port.
-r :v | Run Videotex emulator attached to serial port.
-r :loop | Loopback device on serial port.
-r endpoint | Hook serial port an endpoint (see Endpoint section).
Printer Port Options
-p host:port | Connect printer port to TCP/IP host, port endpoint.
-p @port | Listen for TCP/IP connections on port for printer.
-p :mx70 | Run MX-70 emulator attached to printer port.
-p :ec | Run Electric Crayon emulator attached to printer port.
-p endpoint | Hook printer port an endpoint (see Endpoint section).
-poff | Printer appears powered off
-pp -ppx | Enable/Disable printer window pop-up on print.
View Options
-va | Authentic display (default)
-vs | Sharp display
-vi | Sharp display but only allows integer scaling
-vh | Cheap display
-vN | Scale cheap or sharp display up by N times
-vf | Start in full-screen mode (use Alt+Enter to go windowed)
-vc #RRGGBB | Set display colour to 24 bit colour value ("-vc - " for default)
-vd #RRGGBB | Set beam conflict colour ("-vd -" for default)
-vb #RRGGBB | Set border colour ("-vb -" for default)
-vr type | Set 256 x 192 artifact colours, x off, s swapped, - default
-win WxH | Set window width and height
-win full | Start in full-screen mode (use Alt+Enter to go windowed)
-bd | Turn beam debugging on
-na | Turn off authentic display
-vpfon | Turn Tandy 10 PRINT FORM switch on
-vpfoff | Turn Tandy 10 PRINT FORM switch off
-vrev | Tandy 10 reverse video
-vnorm | Tandy 10 normal video (white background)
-wtfs N | Update window title only every Nth frame.
Sound Options
-s hardware | Enable third party audio for model 1,3 or 4.
| orch80 Orchestra 80
| orch85 Orchestra 85
| orch90 Orchestra 90
| - Disable third party audio
-mute | Start with audio muted.
-vol N | Set audio volume percentage (0 to 100; -sv is synonymous)
-su | Turn off audio filtering (faster; slightly less accurate)
-sx | Disable all audio output
-s1 | Force mono sound
-s2 | Force stereo sound
-sbg | Mute audio if trs80gp does not have the focus
-sfg | Audio and sound effects always play (unlike -sbg)
-sfmute | Mute sound effects
-sfv N | Set sound effect volume percentage
-sf fx file.wav | Use file.wav for named sound effect fx:
| spin-empty empty floppy drive motor on
| spin-floppy floppy spinning in drive
| step floppy drive seeking
| relay-on cassette motor relay activating
| relay-off cassette motor relay turning off
Automation Options
-turbo | Run at top speed
-haste | Run fast by drawing once per second (graphics/timing inaccurate)
-batch | Have "Record" menu save files without prompting.
-fa hex | Update FPS when Z-80 hits address
-ta hex | Turbo for 5 frames at Z-80 address
-rand | Initialize RAM and the R register with random data.
-ct -ctx | Enable/disable cassette auto turbo
-dt -dtx | Enable/disable floppy disk auto turbo
-ht -htx | Enable/disable hard drive auto turbo
-wt -wtx | Enable/disable wafer drive auto turbo
-pt -ptx | Enable/disable printer auto turbo
-iat -iatx | Enable/disable input/paste auto turbo
Keyboard, Joystick and Light Pen Input
-jx | Disable joystick input
-js | Swap joystick inputs
-kl log|phys|typ Set keyboard layout to logical, physical, typing
-kg -kgx | Enable/disable key ghosting on keyboard input
-kt -ktx | Enable/disable keyboard auto de-turbo
-kc | Clustered key layout in software keyboard (Model 4 only)
-ks -ksx | Enable/disable soft capslock (Model 2/12/16/6000 only)
-i str | Send str as keyboard input (as if it were pasted)
-iy str | Send str with current date/time substitution
| %m,%d,%y - month, day, year, %h,%i,%s - hour, minute, second
| %Y - 4 digit year
-if file | Send file contents as keyboard input
-ifr file | Send untranslated file contents as keyboard input
-iw str | Wait until str appears on screen
-ik row mask | Set keyboard matrix row to mask
-ictl reset | Reset the TRS-80
-id N | Delay N frames
-itime N | Give up on input after N frames of waiting (0 to never give up)
-ix | Exit emulator when command line input has been sent
-ib file | Run trs80gp commands from file
-is | Save a screenshot
-ics | Save a clean screenshot (no beam interference dropouts)
-it | Write text VRAM to file
-ig | Write hires graphics VRAM to file
-ic | Write programmable character generator VRAM to file
-im dump N file | Save ASCII image of disk N to file.
-im wp N on|off | Enable or disable write protect on disk N
-im trackdump N file
| Save ASCII image of disk track data of disk N to file
-im disksummary N file
| Save ASCII summary of disk contents
-im disksummarye N file
| ASCII summary with empty sectors marked
-im insert N file
| Insert disk image file into drive N
-im eject N 1 | Eject disk image in drive N with no prompting
-ip host:port | Read keyboard input from TCP/IP host, port endpoint.
-ip @port | Listen for TCP/IP connections on port for keyboard.
-ip endpoint | Hook input to an endpoint (see Endpoint section).
-ir audio | Toggle audio recording (turn on if off, off if on)
-ir flash | Toggle flash video recording
-ir video | Toggle AVI video recording
-ir gif | Toggle animated GIF recording
-ir mhz | Toggle MHz recording
-imacN str | Set input macro N (0..9) to given string
-lp | Enable light pen emulation (1,3,4)
-esc-exits | Pressing the escape key exits trs80gp
Programmer Help
-b hex | Set debugger breakpoint (can use "-b hex" up to 4 times).
-b label | Set breakpoint at label (if .bds file loaded)
-b start:end | Set breakpoints from start to end (0:ffff can be handy)
-bm hex/label | Set Z-80/6800/6809 memory access breakpoint
| also -bmr or -bmw to trap only reads or writes
-bio hex/label | Set Z-80 I/O access breakpoint
| also -bior or -biow to trap only reads or writes
-b16 hex | Set 68000 debugger breakpoint
-b16m hex/label | Set 68000 memory access breakpoint
| also -b16mr or -b16mw to trap only reads or writes
-l file | Load file into memory but don't run it
-ls file.bds | Load symbols from file but don't load its data.
-ee | Enable emulator extensions (debugging oriented)
-trace | Start with tracing on (Record → Trace)
-tr addrset | Start with tracing when PC in given address set.
-trpr name,nm2 | Device values to output in trace log.
-nrs | Don't load any built-in symbols/source code.
-8z | Use Zilog mnemonics when disassembling 8080 code.
-8i | Use Intel mnemonics when disassembling 8080 code.
FreHD Emulation
-frehd | Enable FreHD emulation
-frehd_dir dir | Set directory used for FreHD external file import/export
| Also enables FreHD emulation
-frehd_load fl | Use boot block in file instead of the built-in one
-frehd_patch | Apply FreHD auto-start patches to the ROM
-frehd_menu | Use built-in FreHD menu program rather than frehd.rom
| in the -frehd_dir
Becker Port Options (CoCo only)
-bck host:port | Connect Becker port to TCP/IP host, port endpoint.
-bck @port | Listen for TCP/IP connections on port for Becker port.
-bck :v | Run Videotex emulator attached to Becker port.
-bck endpoint | Hook Becker port to an endpoint (see Endpoint section).
Scripting and Customization
-menu name cmd | Add "name" to Custom menu executing to execute cmd
| -menu Soft [ postmsg keyboard_soft ]
| -menu "Debug Source" [
| [ postmsg debug ]
| [ postmsg source_code ] ]
-cmd cmd | Commands to run at program start
Endpoint Syntax
host:port | Connect to TCP/IP host name and port number.
:port | Connect to TCP/IP port number on localhost.
@port | Listen for TCP/IP connection on port number.
/file/path | Unix serial port like "/dev/ttyUSB0" or a fifo.
>filename | Write all output to a file.
<filename | Read input from file.
<infile>outfile | Read from infile and write to outfile.
|command %p | Run command that will connect to %p TCP/IP port.
:loop | Loopback device on serial port.
:mouse | Emulate 2 button mouse device.
:mouse3 | Emulate 3 button mouse device.
:dt1 | DT-1 emulator.
:gt | Green Thumb emulator.
:v | Videotex emulator.
:mx70 | MX-70 printer emulator.
:ec | Electric Crayon emulator.
[ :model args ] | Pass arguments to :mx70, etc. e.g., [ :mx70 -mute ]
Esoterica
-event endpoint | Send high level system events to an endpoint.
-sync | Try to maintain frame rate exactly (uses excessive CPU)
-trsnic | Preliminary trsnic emulation (model 1,3,4 only)
-time render|frame|emulation | Show timing in title bar
-showkey | Show Windows key code in title bar
-showframe | Show the frame number in title bar
-writerom | Make ROM writeable (Model 1 and 3 only)
-m1_vblank | VBLANK readable as bit 0 of port $FF (Model I only)
-x1hack | Temporary fix for Xenix 1 boot error (and TRSDOS-16)
| (disables 68000 to Z-80 interrupt request through CTC1)
-rtc16 | Enable real time clock for Model 16,6000 (default)
-rtc16x | Disable real time clock for Model 16,6000
-mmu9f | Model I 16 RAM bank 0 when bit 0 of port $9F set.
-t1hack | Modification to when FDC switches to Type I status.
| Only useful to make TRSDOS-II RESTORE work.
-gtdemo | Run Green Thumb demo with Model 3 acting as a server.
| Must be the first option on the command line.