-help Print complete and up-to-date list of command line switches

-v Print emulator version.

-verbose Display framerate when exiting

-configure Starts emulator in run-time configuration mode.

-config filename Specify an alternative configuration filename.

-osa_rom filename Path to file containing Atari Rev.A Operating System. Used to override paths defined at compile time.

-osb_rom filename Path to file containing Atari Rev.B Operating System. Used to override paths defined at compile time.

-xlxe_rom filename Path to file containing Atari XL/XE Operating System. Used to override paths defined at compile time.

-5200_rom filename Path to file containing Atari 5200 Games System ROM. Used to override paths defined at compile time.

-basic_rom filename Path to file containing Atari BASIC ROM. Used to override paths defined at compile time.

-xl Emulate Atari 800 XL.

-xe Emulate Atari 130 XE.

-320xe Emulate Atari 320 XE (Compy Shop)

-rambo Emulate Atari 320 XE (Rambo)

-5200 Emulate Atari 5200 - Games controller emulation has not been implemented yet!

-emuos Use EmuOS

-a Use Atari OS/A.

-b Use Atari OS/B.

-c Enable RAM between $c000 and $d000.

-pal Emulate PAL TV mode

-ntsc Emulate NTSC TV mode

-nobasic Used to disable Basic when starting the emulator in XL/XE mode. Simulates the Option key being held down during system boot.

-basic Turn on Atari BASIC ROM

-cart <filename> Insert cartridge (CART or raw format)

-run <filename> Run Atari executable file (EXE, COM, XEX)

-tape <filename> Attach cassette image (CAS format or raw file)

-boottape <filename> Attach cassette image and boot it

-nopatch Normally the OS is patched giving very fast I/O. This options prevents the patch from being applied so that the OS accesses the serial port hardware directly. This option will probably never be needed since programs that access the serial hardware should work even if the OS has been patched.

-nopatchall Don't patch OS at all, H: and P: devices won't work

-H1 <path> Set path for H1: device

-H2 <path> Set path for H2: device

-H3 <path> Set path for H3: device

-H4 <path> Set path for H4: device

-hdreadonly <onoff> Enable (1) or disable (0) read-only mode for H: device

-devbug Put debugging messages for H: and P: devices in log file

-rtime <onoff> Enable (1) or disable (0) R-Time 8 emulation

-mouse off Do not use mouse

-mouse pad Emulate paddles

-mouse touch Emulate Atari Touch Tablet

-mouse koala Emulate Koala Pad

-mouse pen Emulate Light Pen

-mouse gun Emulate Light Gun

-mouse amiga Emulate Amiga mouse

-mouse st Emulate Atari ST mouse

-mouse trak Emulate Atari Trak-Ball

-mouse joy Emulate joystick using mouse

-mouseport <num> Set mouse port 1-4 (default 1)

-mousespeed <num> Set mouse speed 1-9 (default 3)

-refresh Controls screen refresh rate. A numerical value follows this option which specifies how many emulated screen updates are required before the actual screen is updated. This value effects the speed of the emulation: A higher value results in faster CPU emulation but a less frequently updated screen.

-artif <mode> Set artifacting mode 0-4 (0 = disable)

-palette <filename> Read Atari colors from ACT file

-black <num> Set black level 0-255

-while <num> Set white level 0-255

-colors <num> Set color intensity

-colshift <num> Set color shift

-realpal Use palette created by Zdenek Eisenhammer

-oldpal Use old Atari800 palette

-foxpal Use palette created by Piotr Fusik

-sound Enable sound

-nosound Disable sound

-dsprate <freq> Set mixing frequency (Hz)

-snddelay <time> Set sound delay (milliseconds)

-left Use columns 0 to 39.

-central Use columns 20 to 59.

-right Use columns 40 to 79.

-wide1 Use columns 0 to 79. In this mode only the even character positions are used. The odd locations are filled with spaces.

-wide2 Use columns 0 to 79. This mode is similar to -wide1 except that the spaces are in reverse video if the previous character was also in reverse video.

-interlace <x> Generate Falcon screen only every x frame

-videl Direct VIDEL programming (Falcon/VGA only)

-double Double the screen size on NOVA

-delta Delta screen output (differences only)

-interlace Enable screen interlace option

-interlace Generate screen with interlace

-video <mode> 0=320x200, 1=320x240, 2=320x480 interlaced with black lines, 3=320x480 interlaced with darker lines

-novesa Do not use VESA 2 video modes

-vretrace Use vertical retrace control

-LPTjoy1 Read joystick connected to LPT1

-LPTjoy2 Read joystick connected to LPT2

-LPTjoy3 Read joystick connected to LPT3

-joyswap Swap joysticks

-keyboard 0 PC keyboard layout

-keyboard 1 Atari keyboard layout

-small Runs the emulator in a small window where each Atari 800 pixel is represented by one X Window pixel.

-large Runs the emulator in a large window where each Atari 800 pixel is represented by a 2x2 X Window rectange. This mode is selected by default.

-huge Runs the emulator in a huge window where each Atari 800 pixel is represented by a 3x3 X Window rectange.

-clip_x number-of-pixels Sets left offset for clipping.

-clip_width number-of-pixels Sets the width of the clipping-area.

-clip_y number-of-pixels Sets top offset for clipping.

-clip_height number-of-pixels Sets the height of the clipping-area.

-private_cmap Tells the Emulator to use its own private colormap.

-fps Show framerate

-sio Show SIO monitor

-x11bug Enable debug code in atari_x11.c

-keypad Keypad mode

-rotate90 Runs the emulator with rotated display (useful for devices with 240x320 screen)

-fullscreen Runs in fullscreen (tries to switch to 336x240 resolution)

-windowed Runs in a window (does not change your working resolution)

-width number-of-pixels Host horizontal resolution for fullscreen

-height number-of-pixels Host vertical resolution for fullscreen

-bpp number-of-bits Host color depth for running in fullscreen

-nojoystick SDL Joysticks will not be initialized

-joy0 path-to-device Defines path to device used in LPTjoy 0. Available on linux-ia32 only.

-joy1 path-to-device Defines path to device used in LPTjoy 1. Available on linux-ia32 only.

-audio16 16-bit sound output enabled.

F1 Built in User Interface

F2 Option

F3 Select

F4 Start

F5 Warm Reset

F6 Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)

F7 Break Key

F8 Cold Reset

F9 Exit Emulator

F10 ---

F11 ---

F12 ---

Some control have special meaning within curses and should not be used.

Avoid Control + C, J, M, Q, S and Z

The remaining control characters can be typed. Control characters are displayed on the screen with the associated upper case character in bold.

No Joystick or Paddle support in this version.

F1 Built in User Interface

F2 Option

F3 Select

F4 Start

F5 Warm Reset

Shft+F5 Cold Reset

F6 Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)

F7 Break Key

F8 Enter monitor

F9 EXIT Emulator

Help HELP key (800XL/130XE)

Joystick 0 is operated by the numeric keypad (make sure that the numeric keypad has been enabled). 7 8 9 \|/ 4 5 6 /|\ 1 2 3 And 0 is the fire key. At the moment it is not possible to use a Paddle with this version.

F1 Built in User Interface

F2 Option

F3 Select

F4 Start

F5 Warm Reset

Shft+F5 Cold Reset

F6 Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)

F7 Break Key

F8 Enter monitor

F9 Exit Emulator

F10 Save Screenshot (+Shift=interlaced screenshot)

F11 Joystick Autofire On/Off

F12 ---

` This character replaces the CAPS lock key because I have not found a way of detecting it. A future solution maybe to automatically issue a CAPS lock key when a transition is made between lower and upper case keys. i.e. If svgalib return 'a' followed by 'A' it could send 'a'

The CTRL+SHIFT keyboard combinations are implemented using the left ALT key.

Joystick 0 is operated by the numeric keypad (make sure that the numeric keypad has been enabled).

7 8 9 \|/ 4 5 6 /|\ 1 2 3

And 0 is the fire key.

At the moment it is not possible to use a Paddle with the SVGALIB version.

F1 Built in User Interface

F2 Option Key

F3 Select Key

F4 Start Key

F5 Warm Reset

Shft+F5 Cold Reset

F6 PIL Mode (Atari800) / Help Key (XL/XE)

F7 Switch between Emulated joysticks mode and Normal keyboard

F8 Enter monitor

F9 EXIT Emulator

F10 Save Screenshot (+Shift=interlaced screenshot)

Control-C terminates the program; to type Control-c, type ALT-c instead. ` is used as the Atari-Invers key

Joysticks can be either real one connected to game port, or old 8-bit digital CX-40 joysticks connected to parallel port or keyboard joysticks (try out JOYCFG.EXE). At the moment it is not possible to use a Paddle with this version.

F1 Built in User Interface

F2 Option

F3 Select

F4 Start

F5 Warm Reset

Shft+F5 Cold Reset

F6 Toggle RAM/ROM between 0x8000 and 0xbfff (PIL Mode)

F7 Break Key

F8 ---

F9 Exit Emulator

F10 ---

F11 Vertical Positioning: Scroll Screen Downwards

F12 Vertical Positioning: Scroll Screen Upwards

ALT Atari Key (Either ALT Key will work)

Joystick 0 is operated by the mouse position relative to the center of the screen. The mouse button acts as the trigger. On Linux, standard joysticks are also supported.

Paddle 0 is operated by moving the mouse pointer across the window.

LALT+f switching FULLSCREEN (probably doesn't work in Windows)

LALT+g switching WIDTH_MODE (so you can set 320x240)

LALT+b switching BLACK-AND-WHITE (feel to power of BW monitor!)

LALT+j swapping _keyboard_emulated_ joysticks

LALT+e switching bpp (for debug only, will be removed soon)

To redefine keys for joystick emulation you must modify SDL_TRIG_* and SDL_JOY_* in atari_sdl.c, then recompile Atari800. In source you can also turn off sound or change defaults (FULLSCREEN, BW, SWAP_JOYSTICKS, WIDTH_MODE).

On Linux, standard joysticks are supported.