Command Line Option Summary

OptionEffect
Hardware Selection
-m1Emulate Model I
-mjEmulate Japanese Model I
-m2Emulate Model II
-m3Emulate Model III (default)
-m3nEmulate Norcom Model III clone that fit in a Model I case
-m4Emulate Model 4 (same as -m4a)
-m4aEmulate Model 4 with 2 wait states per instruction
-m4bEmulate Model 4 with 1 wait state per instruction
-m4cEmulate Model 4 with no wait states per instruction
-m4gaEmulate Model 4 Gate Array
-m4pEmulate Model 4P
-m4dEmulate Model 4D
-m4ssEmulate Model 4 Student Station
-m12Emulate Model 12
-m16Emulate Model 16
-m6000Emulate Model 6000
-mc10Emulate Micro Color Computer Model MC-10
-mcEmulate Color Computer
-mdt1Emulate DT-1 Terminal
-mvEmulate Videotex Terminal
-mecEmulate Electric Crayon
-mx70Act like MX-70 Printer
-l1Run Level I BASIC ROM (Model I or III)
-l2Run Level II BASIC ROM (default) (Model I or III)
-rNUse ROM revision N (-r0, -r1, -r2, ...)
-nlcNo lowercase for Model I
-lldLoad Model I lowercase driver from cassette on startup
-nldDo not load Model I lowercase driver from cassette
-nscDo not try to set the clock for the boot OS
-altUse alternate character set
-charrom fileUse character generator ROM from file
-50Set frame rate to 50 Hz
-gXHires graphics: -g0 none, -gt Tandy, -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
-ddTYPESelect Model I floppy doubler: -ddx none, -ddp Percom,
-ddr Radio Shack, -ddrp RS+Percom, -ddd detect at boot)
-dxDisable floppy disk controller (boot into ROM BASIC).
-dNssSet drive N (0,1,2,3) single-sided only.
-dNdsSet drive N (0,1,2,3) double-sided only.
-dNasSet drive N (0,1,2,3) to automatically act as single or double-sided.
-hxDisable hard drive controller
-mem nEmulate n KB of RAM
-mem type:nEmulate n KB of hyper/super/mega expansion RAM.
-mem16 nEmulate n KB of 68000 RAM
-memgap16 b nUnmap an n KB gap in 68000 RAM starting at KB b
-mmu16 bitsSet number of extension bits in 68000 MMU (default 3)
-z180Use Z-180 as main CPU (Model 2) with XLR8er support (Model 4)
-mhz16 nRun 68000 at n MHz (default 8)
-rom fileUse ROM image from file
-rom1 fileMap ROM image from file to $3000 (Model 1 only)
-aftAculab floppy tape (Model I only)
-80-grafix80-Grafix hires character generator (Model I only)
-80-grafix+80-Grafix+ hires character generator (Model I only)
-pcg-80PCG-80 hires character generator (Model I only)
-80-grafix380-Grafix3 hires character generator (Model III only)
-omikronOmikron Mapper for Model I (for Omikron CP/M)
-omikron-aOmikron Mapper using version A ROM
-pak fileUse Colour Computer Program Pak (cartridge) ROM from file.
Program/Media Selection
-c file.casInsert cassette file.cas
-w file.tapeInsert floppy tape wafer file.tape into next free drive
-dN file.dskInsert disk into drive N (0,1,2,3)
-d file.dskInsert disk into next free drive
-d dmkInsert unformatted disk into next free drive (.dmk format)
(add -ds for double-sided and #N for tracks)
-d imdInsert unformatted disk into next free drive (.imd format)
-d :nameInsert internal diskette ":name" into next free drive
-tdBoot TRS-DOS (default)
-ldBoot LDOS or LS-DOS
-d0 -Don't insert TRS-DOS disk
-h file.hdvAttach hard drive to next free slot
-hN file.hdvAttach hard drive to slot N
-cs -csxEnable/disable cassette auto save
file.dskInsert disk into next free drive (also .dmk, .imd)
file.tapeInsert floppy tape wafer into next free drive
file.cccInsert Colour Computer Program Pak ROM (CoCo only)
:nameInsert internal diskette or wafer into next free drive
fileOne 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
Serial Port (RS-232) Options
-rxDisable RS-232
-r host:portConnect serial port to TCP/IP host, port endpoint.
-r @portListen for TCP/IP connections on port for serial line.
(also -rB for second and -rA for first serial port)
-r :mouseEmulate 2 button mouse on serial port
-r :mouse3Emulate 3 button mouse on serial port
-r :dt1Run DT-1 emulator attached to serial port.
-r :vRun Videotex emulator attached to serial port.
-r :loopLoopback device on serial port.
Printer Port Options
-p host:portConnect printer port to TCP/IP host, port endpoint.
-p @portListen for TCP/IP connections on port for printer.
-p :mx70Run MX-70 emulator attached to printer port.
-p :ecRun Electric Crayon emulator attached to printer port.
-poffPrinter appears powered off
-pp -ppxEnable/Disable printer window pop-up on print.
View Options
-vaAuthentic display (default)
-vsSharp display
-viSharp display but only allows integer scaling
-vhCheap display
-vNScale cheap or sharp display up by N times
-vfStart in full-screen mode (use Alt+Enter to go windowed)
-vc #RRGGBBSet display colour to 24 bit colour value ("-vc - " for default)
-vd #RRGGBBSet beam conflict colour ("-vd -" for default)
-vb #RRGGBBSet border colour ("-vb -" for default)
-vr typeSet 256 x 192 artifact colours, x off, s swapped, - default
-win WxHSet window width and height
-win fullStart in full-screen mode (use Alt+Enter to go windowed)
-bdTurn beam debugging on
-naTurn off authentic display
-wtfs NUpdate window title only every Nth frame.
Sound Options
-s hardwareEnable third party audio for model 1,3 or 4.
orch80 Orchestra 80
orch85 Orchestra 85
orch90 Orchestra 90
- Disable third party audio
-muteStart with audio muted.
-vol NSet audio volume percentage (0 to 100; -sv is synonymous)
-suTurn off audio filtering (faster; slightly less accurate)
-sxDisable all audio output
-s1Force mono sound
-s2Force stereo sound
-sbgMute audio if trs80gp does not have the focus
-sfgAudio and sound effects always play (unlike -sbg)
-sfmuteMute sound effects
-sfv NSet sound effect volume percentage
-sf fx file.wavUse 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
-turboRun at top speed
-hasteRun fast by drawing once per second (graphics/timing inaccurate)
-batchHave "Record" menu save files without prompting.
-fa hexUpdate FPS when Z-80 hits address
-ta hexTurbo for 5 frames at Z-80 address
-randInitialize RAM and the R register with random data.
-ct -ctxEnable/disable cassette auto turbo
-dt -dtxEnable/disable floppy disk auto turbo
-ht -htxEnable/disable hard drive auto turbo
-wt -wtxEnable/disable wafer drive auto turbo
-pt -ptxEnable/disable printer auto turbo
-iat -iatxEnable/disable input/paste auto turbo
Keyboard, Joystick and Light Pen Input
-jxDisable joystick input
-jsSwap joystick inputs
-kl log|physSet keyboard layout to logical or physical
-kg -kgxEnable/disable key ghosting on keyboard input
-kt -ktxEnable/disable keyboard auto de-turbo
-kcClustered key layout in software keyboard (Model 4 only)
-ks -ksxEnable/disable soft capslock (Model 2/12/16/6000 only)
-i strSend str as keyboard input (as if it were pasted)
-iy strSend str with current date/time substitution
%m,%d,%y - month, day, year, %h,%i,%s - hour, minute, second
%Y - 4 digit year
-if fileSend file contents as keyboard input
-iw strWait until str appears on screen
-ik row maskSet keyboard matrix row to mask
-ictl resetReset the TRS-80
-id NDelay N frames
-itime NGive up on input after N frames of waiting (0 to never give up)
-ixExit emulator when command line input has been sent
-isSave a screenshot
-icsSave a clean screenshot (no beam interference dropouts)
-itWrite text VRAM to file
-igWrite hires graphics VRAM to file
-icWrite programmable character generator VRAM to file
-im dump N fileSave ASCII image of disk N to file.
-im wp N on|offEnable or disable write protect on disk N
-im trackdump N file
Save ASCII image of disk track data of disk N to file
-im insert N file
Insert disk image file into drive N
-im eject N 1Eject disk image in drive N with no prompting
-ip host:portRead keyboard input from TCP/IP host, port endpoint.
-ip @portListen for TCP/IP connections on port for keyboard.
-ir audioToggle audio recording (turn on if off, off if on)
-ir flashToggle flash video recording
-ir videoToggle AVI video recording
-ir gifToggle animated GIF recording
-ir mhzToggle MHz recording
-lpEnable light pen emulation (1,3,4)
-esc-exitsPressing the escape key exits trs80gp
Programmer Help
-b hexSet debugger breakpoint (can use "-b hex" up to 4 times).
-b labelSet breakpoint at label (if .bds file loaded)
-b start:endSet breakpoints from start to end (0:ffff can be handy)
-bm hex/labelSet Z-80/6800/6809 memory access breakpoint
also -bmr or -bmw to trap only reads or writes
-bio hex/labelSet Z-80 I/O access breakpoint
also -bior or -biow to trap only reads or writes
-b16 hexSet 68000 debugger breakpoint
-b16m hex/labelSet 68000 memory access breakpoint
also -b16mr or -b16mw to trap only reads or writes
-l fileLoad file into memory but don't run it
-ls file.bdsLoad symbols from file but don't load its data.
-eeEnable emulator extensions (debugging oriented)
-traceStart with tracing on (Record → Trace)
-nrsDon't load any built-in symbols/source code.
FreHD Emulation
-frehdEnable FreHD emulation
-frehd_dir dirSet directory used for FreHD external file import/export
Also enables FreHD emulation
-frehd_load flUse boot block in file instead of the built-in one
-frehd_patchApply FreHD auto-start patches to the ROM
-frehd_menuUse built-in FreHD menu program rather than frehd.rom
in the -frehd_dir
Esoterica
-syncTry to maintain frame rate exactly (uses excessive CPU)
-trsnicPreliminary trsnic emulation (model 1,3,4 only)
-time render|frame|emulationShow timing in title bar
-showkeyShow Windows key code in title bar
-showframeShow the frame number in title bar
-writeromMake ROM writeable (Model 1 and 3 only)
-m1_vblankVBLANK readable as bit 0 of port $FF (Model I only)
-x1hackTemporary fix for Xenix 1 boot error (and TRSDOS-16)
(disables 68000 to Z-80 interrupt request through CTC1)
-mmu9fModel I 16 RAM bank 0 when bit 0 of port $9F set.
-t1hackModification to when FDC switches to Type I status.
Only useful to make TRSDOS-II RESTORE work.