|-help||Print complete and up-to-date list of command line switches|
|-v||Print emulator version|
|-verbose||Display framerate when exiting|
|Specify an alternative configuration filename|
|Automatically save the current configuration on emulator exit.|
Dont save the current configuration on emulator exit (the default).
|Path to file containing Atari Rev.A Operating System.|
|Path to file containing Atari Rev.B Operating System.|
|Path to file containing Atari XL/XE Operating System.|
|Path to file containing Atari 5200 Games System ROM.|
Path to file containing Atari BASIC ROM.
Used to override paths defined at compile time.
Select operating system revision for Atari 800:
Select operating system revision for Atari XL/XE:
Select BIOS revision for Atari 5200:
Select BASIC revision:
Select XEGS builtin game version:
|-atari||Emulate Atari 400/800|
|-1200||Emulate Atari 1200XL|
|-xl||Emulate Atari 800XL|
|-xe||Emulate Atari 130XE|
|-320xe||Emulate Atari 320XE (Compy-Shop)|
|-rambo||Emulate Atari 320XE (Rambo)|
|-xegs||Emulate Atari XEGS|
|-5200||Emulate Atari 5200|
Enable RAM between 0xc000 and 0xcfff in Atari 800
|-axlon n||Use Atari 800 Axlon memory expansion: n k total RAM|
|-axlon0f||Use Axlon shadow at 0x0fc0-0x0fff|
|-mosaic n||Use 400/800 Mosaic memory expansion: n k total RAM|
|-mapram||Enable the MapRAM memory expansion. Works only when emulating an Atari XL/XE machine.|
Disable the MapRAM memory expansion.
|-pal||Emulate PAL TV mode|
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.|
Turn on Atari BASIC ROM
|Insert cartridge (CART or raw format)|
Select type of the cartridge inserted with the -cart option.
When inserting a raw ROM image its type cannot be detected automaticcaly,
and must be provided with this option.
Setting to 0 means disabling the cartridge, and any other number
indicates a specific cartridge type:
|Insert piggyback cartridge (CART or raw format). This works only if the first cartridge is a pass-through (currently only SpartaDOS X 64KB and 128KB types).|
|Select type of the cartridge inserted with the -cart2 option. When inserting a raw ROM image its type cannot be detected automatically, and must be provided with this option. The available values are the same as for the -cart-type option above.|
|Automatically reboot after cartridge inserting/removing (this is the default setting). This does not apply to the piggyback cartridge - inserting or removing it never causes automatic reboot.|
Disable automatic reboot after cartridge inserting/removing.
|Run Atari program (EXE, COM, XEX, BAS, LST)|
|Load saved-state file|
|Attach cassette image (CAS format or raw file)|
|Attach cassette image and boot it|
Set the attached cassette image as read-only.
|-1400||Emulate the Atari 1400XL|
|-xld||Emulate the Atari 1450XLD|
|-bb||Emulate the CSS Black Box|
Emulate the ICD MIO board
|-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.|
Dont patch OS at all, H:, P: and R: devices wont 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|
|Set path for Atari executables on the H: device|
|Enable read-only mode for H: device|
|Disable read-only mode for H: device|
Put debugging messages for H: and P: devices in log file
|-rtime||Enable R-Time 8 emulation|
Disable R-Time 8 emulation
Enable R: device.
If dev is specified then its used as host serial device name (e.g.
/dev/ttyS0 on linux).
If there is no dev specified then R: is directed to network.
|Do not use mouse|
|Emulate Atari Touch Tablet|
|Emulate Koala Pad|
|Emulate Light Pen|
|Emulate Light Gun|
|Emulate Amiga mouse|
|Emulate Atari ST mouse|
|Emulate Atari Trak-Ball|
|Emulate joystick using mouse|
|Set mouse port 1-4 (default 1)|
|Set mouse speed 1-9 (default 3)|
|Emulate MultiJoy4 interface|
|Use mouses absolute position|
|-cx85 num||Emulate CX85 numeric keypad on port num|
SDL only, prevent mouse pointer from leaving the window
|Record all input events to filename. Can be used for gaming contests (highest score etc).|
Playback input events from filename. Watch an expert play the game.
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.
|-ntsc-artif mode, -pal-artif mode|
Set emulation mode of video artifacts in NTSC or PAL, respectively. The
available values for mode are:
Set artifacting mode 0-4 (0 = disable). Only for tv effects ntsc-old and ntsc-new.
|Use one of predefined colour adjustments|
|Set screen color saturation (like TV Colour control)|
|-ntsc-saturation n, -pal-saturation n|
|Set saturation only for NTSC or PAL, respectively|
|Set screen contrast (also called white level)|
|-ntsc-contrast n, -pal-contrast -fIn|
|Set contrast only for NTSC or PAL, respectively|
|Set screen brightness (also called black level)|
|-ntsc-brightness n, -pal-brightness n|
|Set brightness only for NTSC or PAL, respectively|
|-gamma n||Set screen gamma correction|
|-ntsc-gamma n, -pal-gamma n|
|Set gamma adjustment only for NTSC or PAL, respectively|
|-tint n||Set tint -1..1.|
|-ntsc-tint n, -pal-tint n|
|Set tint only for NTSC or PAL, respectively|
|Set GTIA color delay for NTSC system. This emulates adjusting the potentiometer existing at the bottom of Atari computers, which adjusts hues of colors produced by the computer.|
Set GTIA color delay for PAL system.
|-paletten filename, -palettep filename|
|Read Atari NTSC/PAL colors from ACT file|
Apply colour adjustments (brightness, contrast etc.) to the loaded NTSC/PAL
palette (by default the loaded palette is displayed unmodified).
Set filename pattern for screenshots.
Use to override the default atari000.png, atari001.png etc.
Hashes are replaced with raising numbers.
Existing files are overwritten only if all the files defined by the pattern
Show percentage of actual speed
|Set sound output frequency in Hz. The default is 44100 Hz.|
|-audio16||Set sound output format to 16-bit|
|-audio8||Set sound output format to 8-bit|
|Set size of the hardware sound buffer (fragment size). The value should be a power of 2. Setting to 0 (the default) causes the size to be set automatically. Higher values increase sound latency. Automatic setting should be OK in most cases.|
Set sound latency in milliseconds.
Increase it if you experience gaps of silence during sound playback.
-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) -joyswap Swap joysticks
-scale n Scale width and height by n
-fullscreen Start in fullscreen mode. The default resolution is 336x240 and can be later changed. -windowed Start in a window (the default). -rotate90 Rotate display (useful for devices with 240x320 screen). -no-rotate90 Dont rotate display (the default). -fs-width number-of-pixels Host horizontal resolution for fullscreen. -fs-height number-of-pixels Host vertical resolution for fullscreen. -win-width number-of-pixels Set horizontal size of the window. The window can be later resized manually. -win-height number-of-pixels Set vertical size of the window. The window can be later resized nanually. -bpp number-of-bits Sets image color depth when OpenGL acceleration is disabled. Accepted values are: 0 (use desktop depth; this is the default), 8, 16 and 32. Depending on the type of graphics hardware, the fullscreen setting and current desktop bit depth, either of the values might give the best performance. Note that with bit depth set to 16 emulation of colors is slightly less accurate. -vsync Synchronize the display with the monitors vertical retrace, to remove image tearing artifacts. This improves display quality, but may be not available depending on the current wideo mode (fullscreen/windowed), the chosen SDL_VIDEODRIVER and type of graphics hardware. Synchronization is available for some SDL videodrivers (directx, dga) but not for others. In OpenGL this option has no effect - vertical synchronization must be instead enabled in the video hardware drivers settings, if available. -no-vsync Disable synchronization with monitors vertical retrace (the default). -horiz-area narrow|tv|full|number Set amount of visible screen horizontally:
narrow Shows 320 pixels. tv The default. Shows area visible on a standard TV (336 pixels). full Shows full overscan area (384 pixels). number An exact horizontal size can be set by providing a number between 160 and 384. -vertical-area short|tv|full|number Set amount of visible screen vertically:
short Shows 200 pixels. tv The default. Shows area visible on a typical TV (224 or 240 pixels, depending on current TV system). full Shows full overscan area, which can be up to 300 pixels in case of the XEP80. number An exact number of visible scanlines can be set by providing a number between 100 and 300. Note that when displaying output of an XEP80 or Austin Franklin 80 column card, the tv setting will crop the top and bottom parts of text area, just like a real TV does - in such case setting the option to full would be more appriopriate. -horiz-shift number When the visible horizontal area is not set to full, this option specifies the screens area that will be visible. Values higher than 0 will cause showing more of the right side of the screen, while values lower than 0 will cause showing more of the left side. The default is 0 (no shift). -vert-shift number Analogically to -horiz-shift: when the visible vertical area is not set to full, this option specifies the screens area that will be visible. Values higher than 0 will cause showing more of the bottom part of the screen, while values lower than 0 will cause showing more of the top part. The default is 0 (no shift). -stretch none|integral|full|number Choose method of stretching the image to fit the screen/window area:
none The image wont be stretched at all. integral The default. The image will fit the screen/window but will be stretched only by an integral multiplier. This setting allows for nice output when using scanlines in low screen resolutions. full The screen will fit the entire screen/window area. This setting looks best in high screen resolutions. number A custom multiplier (floating point number) can be also provided to precisely set the amount of stretching. -fit-screen width|height|both When -stretch is set to integral or full, this parameter controls how the stretching is performed with relation to window/screen size:
width Fits the images width while allowing it to be cropped vertically. height Fits the images height while allowing it to be cropped horizontally. both The default. Fit both the images width and height, avoiding cropping. -image-aspect none|square-pixels|real Choose how the images aspect ratio should be maintained when stretching:
none Causes the image to be stretched without restriction to fit the screen/window area fully. square-pixels The default. Causes the image to be stretched by the same amount horizontally and vertically, maintaining square pixels. In low screen resolutions this setting may produce the nicest result. real Recreates the aspect ratio of a real TV display (pixels are not square), but only if the -host-aspect-ratio option is set correctly. -host-aspect-ratio auto|x:y Set the aspect ratio of the host monitor on which the emulators display is placed. Allowed values are auto for autodetection, or ratios like 4:3, 16:9, 1.25:1 ... This value is used to properly maintain images aspect ratio when having -image-aspect set to real. The default value is auto. Note that host aspect ratio detection works as expected only if the desktop resolution matches aspect ratio of the display device (in other words, display pixels are square). If, for example, desktop resolution is 800x600 on a 16:9 monitor, autodetection will fail and host aspect ratio will have to be set manually, by measuring physical width and height of the monitor and setting the parameter to width:height. -80column Shows output of an 80 column hardware, when it is available (the default). This parameter has effect only if an 80 column hardware is activated, using one of the parameters -af80, -proto80 or -af80. -no-80column Deactivates showing output of an 80 column hardware.
-nojoystick Do not initialize SDL joysticks -joy0 path-to-device Define path to device used in LPTjoy 0. Available on linux-ia32 only. -joy1 path-to-device Define path to device used in LPTjoy 1. Available on linux-ia32 only.
-ntsc-filter-preset composite|svideo|rgb|monochrome Use one of predefined NTSC filter adjustments. -ntsc-sharpness n Set sharpness of the NTSC filter. -ntsc-resolution n Set resolution of the NTSC filter. -ntsc-artifacts n Set artifacts of the NTSC filter. -ntsc-fringing n Set fringing of the NTSC filter. -ntsc-bleed n Set bleed of the NTSC filter. -ntsc-burstphase n Set burst phase of the NTSC filter. This changes colors of artifacts. The best values are 0, 0.5, 1, 1.5. -scanlines n Set visibility of scanlines (0..100). Scanlines are only visible when the screens or windows vertical size is at least 480 (more precisely, at least twice the number of scanlines given in -vert-area). -scanlinesint Enable scanlines interpolation (looks nicer). -no-scanlinesint Disable scanlines interpolation (in software modes may give better performance). -video-accel Use OpenGL hardware acceleration for displaying and stretching of the emulators display. Using OpenGL improves performance. -no-video-accel Dont use OpenGL hardware acceleration (the default). -pixel-format bgr16|rgb16|bgra32|argb32 Choose format of texture data when OpenGL acceleration is enabled. Depending on the type of the graphics hardware, either of the values might give the best performance. Note that with pixel format set to bgr16 or rgb16, emulation of colors is slightly less accurate. -pbo Use Pixel Buffer Objects when OpenGL acceleration is enabled (the default). PBOs are available on newer graphics hardware and when used, substantially improve emulators performance. However in rare cases (some Intel on-board chips) using PBOs may actually descrease perfromance. -no-pbo Dont use Pixel Buffer Objects when OpenGL acceleration is used. -bilinear-filter Enable bilinear filtering of the screen in OpenGL modes. -no-bilinear-filter Disable bilinear filtering in OpenGL modes (the default). -opengl-lib path Provide a custom OpenGL shared library. If not given, Atari800 will use a default system-specific library (typically opengl32.dll or libGL.so). -proto80 Emulate a prototype 80 column board for the 1090 -xep80 Emulate the XEP80 -xep80port n Use XEP80 on joystick port n -af80 Emulate the Austin Franklin 80 column daughterboard for Atari 800.
-small Run 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 rectangle. 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 rectangle. -clip_x number-of-pixels Set left offset for clipping -clip_width number-of-pixels Set the width of the clipping-area -clip_y number-of-pixels Set top offset for clipping -clip_height number-of-pixels Set the height of the clipping-area -private_cmap Use private colormap -sio Show SIO monitor -x11bug Enable debug code in atari_x11.c
-keypad Keypad mode
F1 Built in user interface F2 Option key F3 Select key F4 Start key F5 Reset key ("warm reset") Shift+F5 Reboot ("cold reset") F6 Help key (XL/XE only) F7 Break key F8 Enter monitor F9 Exit emulator F10 Save screenshot Shift+F10 Save interlaced screenshot Alt+R Run Atari program Alt+D Disk management Alt+C Cartridge management Alt+Y Select system Alt+O Sound settings Alt+W Sound recording start/stop Alt+S Save state file Alt+L Load state file Alt+A About the emulator Insert Insert line (Atari Shift+>) Ctrl+Insert Insert character (Atari Ctrl+>) Shift+Ctrl+Insert Shift+Ctrl+> Delete Delete line (Atari Shift+Backspace) Shift+Backspace Delete line (Atari Shift+Backspace) Ctrl+Delete Delete character (Atari Ctrl+Backspace) Ctrl+Backspace Delete character (Atari Ctrl+Backspace) Shift+Ctrl+Delete Shift+Ctrl+Backspace Shift+Ctrl+Backspace Shift+Ctrl+Backspace Home Clear (Atari Shift+<) Ctrl+Home Ctrl+< (also clears screen) Shift+Ctrl+Home Shift+Ctrl+< ~ Inverse video Up Up (Atari Ctrl+-) Down Down (Atari Ctrl+=) Left Left (Atari ctrl++) Right Right (Atari ctrl+*) Ctrl+Up - Ctrl+Down = Ctrl+Left + Ctrl+Right * Shift+Up _ (Atari Shift+-) Shift+Down | (Atari Shift+=) Shift+Left (Atari Shift++) Shift+Right ^ (Atari Shift+*) Shift+Ctrl+Up Shift+Ctrl+- Shift+Ctrl+Down Shift+Ctrl+= Ctrl+\ Ctrl+Esc (Workaround for Windows) Shift+Ctrl+\ Shift+Ctrl+Esc (Workaround for Windows)
Paddles, Atari touch tablet, Koala pad, light pen, light gun, ST/Amiga mouse, Atari trak-ball, joystick and Atari 5200 analog controller are emulated using mouse on ports that support it. See the options above for how to enable mouse.
host keypad 0123456789-. 0123456789-. host keypad NO host keypad Ctrl+/ ESCAPE host keypad * DELETE host keypad + YES host keypad Enter +ENTER
No function keys or Alt+letter shortcuts. Use Ctrl+C to enter the monitor. Controllers not supported in this version.
F10 (Save screenshot) does not work in the default CURSES_BASIC build. Shift+F5 and Shift+F10 dont work at all. Avoid Ctrl + C, H, 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.
Controllers not supported in this version.
Joystick 0 is operated by the numeric keypad (make sure that the numeric keypad has been enabled).
Help Help key (XL/XE)
7 8 9
4 5 6
1 2 3
And 0 is the fire key.
Mouse not supported in this version.
The following keys work only when the NTSC filter is enabled (-ntsc-artif set to ntsc-full):
Atari/Inverse key LSUPER Atari/Inverse key (unusable under Windows) RSUPER CapsToggle (+Shift = CapsLock)
LAlt+F Switch fullscreen/windowed display. LAlt+G Switch visible horizontal area. See -horiz-area. LAlt+J Swap keyboard_emulated joysticks LAlt+M Grab mouse (prevents mouse pointer from leaving the window)
LAlt+LShift+1 Decrease tint (also called hue) LAlt+1 Increase hue LAlt+LShift+2 Decrease saturation (like TV Colour control) LAlt+2 Increase saturation LAlt+LShift+3 Decrease contrast (also called white level) LAlt+3 Increase contrast LAlt+LShift+4 Decrease brightness (also called black level) LAlt+4 Increase brightness LAlt+LShift+5 Decrease gamma adjustment LAlt+5 Increase gamma adjustment LAlt+LShift+6 Decrease color delay (Atari color adjustment potentiometer) LAlt+6 Increase color delay
LAlt+LShift+7 Decrease sharpness LAlt+7 Increase sharpness LAlt+LShift+8 Decrease resolution LAlt+8 Increase resolution LAlt+LShift+9 Decrease artifacts LAlt+9 Increase artifacts LAlt+LShift+0 Decrease fringing LAlt+0 Increase fringing LAlt+LShift+- Decrease bleed LAlt+- Increase bleed LAlt+LShift+= Decrease NTSC burst phase (use this to change artifacting colours) LAlt+= Increase NTSC burst phase
Apart from standard joysticks (handled by the SDL) up to two keyboard joysticks are supported. The keys used for joystick directions and the trigger can be freely defined in the config UI (Controller Config -> Define layout). Keyboard joystick emulation can be enabled/disabled in the Controller Config. By default, joy 0 is enabled and joy 1 is disabled (to not steal normal AWDS keys in the emulator).
LAlt+LShift+[ Decrease scanlines visibility LAlt+[ Increase scanlines visibility LAlt+] Toggle NTSC composite/S-Video/RGB/monochrome settings
LAlt+Shift+X Enable/disable output of a 80 column hardware (use with -xep80, -proto80 or -af80).
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.
Alt Atari key (either Alt key will work)
/usr/share/atari800/ATARIOSA.ROM Atari O/S A /usr/share/atari800/ATARIOSB.ROM Atari O/S B /usr/share/atari800/ATARIXL.ROM Atari 800XL O/S /usr/share/atari800/ATARI5200.ROM Atari 5200 O/S /usr/share/atari800/ATARIBAS.ROM Atari Basic
See the BUGS file.
|Atari800 3.1.0||ATARI800 (1)||2014-04-12|