1ATARI800(1) General Commands Manual ATARI800(1)
2
6 atari800 - emulator of Atari 8-bit computers and the 5200 console
7
10 atari800 [option]... [file]...
11
14 atari800 emulates the Atari 8-bit computer systems including the 400,
15 800, 1200XL, 600XL, 800XL, 65XE, 130XE, 800XE and the XE Game System,
16 and also the Atari 5200 SuperSystem console.
17
20 -help Print complete and up-to-date list of command line switches
21 -v Print emulator version
23 -verbose
25 Display framerate when exiting
26 -config filename
28 Specify an alternative configuration filename
29 -autosave-config
31 Automatically save the current configuration on emulator exit.
32 -no-autosave-config
34 Don't save the current configuration on emulator exit (the de‐
35 fault).
36 -osa_rom filename
39 Path to file containing Atari Rev.A Operating System.
40 -osb_rom filename
42 Path to file containing Atari Rev.B Operating System.
43 -xlxe_rom filename
45 Path to file containing Atari XL/XE Operating System.
46 -5200_rom filename
48 Path to file containing Atari 5200 Games System ROM.
49 -basic_rom filename
51 Path to file containing Atari BASIC ROM. Used to override paths
52 defined at compile time.
53 -800-rev auto|a-ntsc|a-pal|b-ntsc|custom|altirra
56 Select operating system revision for Atari 800:
57 auto The default. Use the most appropriate from the available
59 ones.
60 a-ntsc Use OS rev. A NTSC from early NTSC 400/800 units.
61 a-pal Use OS rev. A PAL from PAL 400/800 units.
62 b-ntsc Use OS rev. B NTSC from late NTSC 400/800 units.
63 custom Use a custom OS.
64 altirra
65 Use AltirraOS that is included in the emulator.
66 -xl-rev auto|10|11|1|2|3a|3b|5|3|4|59|59a|custom|altirra
68 Select operating system revision for Atari XL/XE:
69 auto The default. Use the most appropriate from the available
71 ones.
72 10 Use OS AA000000 rev. 10 from early 1200XL units.
73 11 Use OS AA000001 rev. 11 from late 1200XL units.
74 1 Use OS BB000000 rev. 1 from the 600XL.
75 2 Use OS BB000001 rev. 2 from the 800XL and early
76 65XE/130XE units.
77 3a Use prototype OS BB000002 rev. 3 from 1400XL/1450XLD
78 units (also known as 1540OS3.V0 and 1450R3V0.ROM).
79 3b Use prototype OS BB000002 rev. 3 ver. 4 from
80 1400XL/1450XLD units (also known as os1450.128 and
81 1450R3VX.ROM).
82 5 Use prototype OS CC000001 rev. 4 (also known as Rev. 5),
83 for which sources are available at
84 <http://www.atariage.com/forums/topic/78579-a800os‐
85 src/page__view__findpost__p__961535>.
86 3 Use OS BB000001 rev. 3 from late 65XE/130XE units.
87 4 Use OS BB000001 rev. 4 from the XEGS.
88 59 Use OS BB000001 rev. 59 from the Arabic 65XE.
89 59a Use OS BB000001 rev. 59 from Kevin Savetz' Arabic 65XE:
90 <http://www.savetz.com/vintagecomputers/arabic65xe/>.
91 custom Use a custom OS.
92 altirra
93 Use AltirraOS that is included in the emulator.
94 -5200-rev auto|orig|a|custom|altirra
96 Select BIOS revision for Atari 5200:
97 auto The default. Use the most appropriate from the available
99 ones.
100 orig Use BIOS from 4-port and early 2-port 5200 units.
101 a Use BIOS rev. A from late 2-port 5200 units.
102 custom Use a custom BIOS.
103 altirra
104 Use Altirra BIOS that is included in the emulator.
105 -basic-rev auto|a|b|c|custom|altirra
107 Select BASIC revision:
108 auto The default. Use the most appropriate from the available
110 ones.
111 a Use BASIC rev. A.
112 b Use BASIC rev. B from early 600XL/800XL units.
113 c Use BASIC rev. C from late 600XL/800XL and all XE units.
114 custom Use a custom BASIC.
115 altirra
116 Use Altirra BASIC that is included in the emulator.
117 -xegame-rev auto|orig|custom
119 Select XEGS builtin game version:
120 auto The default. Use the most appropriate from the available
122 ones.
123 orig Use the original Missile Command game.
124 custom Use a custom game ROM.
125 -atari Emulate Atari 400/800
128 -1200 Emulate Atari 1200XL
130 -xl Emulate Atari 800XL
132 -xe Emulate Atari 130XE
134 -320xe Emulate Atari 320XE (Compy-Shop)
136 -rambo Emulate Atari 320XE (Rambo)
138 -576xe Emulate Atari 576XE
140 -1088xe
142 Emulate Atari 1088XE
143 -xegs Emulate Atari XEGS
145 -5200 Emulate Atari 5200
147 -c Enable RAM between 0xc000 and 0xcfff in Atari 800
149 -axlon n
152 Use Atari 800 Axlon memory expansion: n k total RAM
153 -axlon0f
155 Use Axlon shadow at 0x0fc0-0x0fff
156 -mosaic n
158 Use 400/800 Mosaic memory expansion: n k total RAM
159 -mapram
161 Enable the MapRAM memory expansion. Works only when emulating an
162 Atari XL/XE machine.
163 -no-mapram
165 Disable the MapRAM memory expansion.
166 -pal Emulate PAL TV mode
169 -ntsc Emulate NTSC TV mode
171 -nobasic
174 Used to disable Basic when starting the emulator in XL/XE mode.
175 Simulates the Option key being held down during system boot.
176 -basic Turn on Atari BASIC ROM
178 -cart filename
181 Insert cartridge (CART or raw format)
182 -cart-type 0..75
184 Select type of the cartridge inserted with the -cart option.
185 When inserting a raw ROM image its type cannot be detected auto‐
186 maticcaly, and must be provided with this option. Setting to 0
187 means disabling the cartridge, and any other number indicates a
188 specific cartridge type:
189 1 Standard 8 KB cartridge
191 2 Standard 16 KB cartridge
192 3 OSS two chip 16 KB cartridge (034M)
193 4 Standard 32 KB 5200 cartridge
194 5 DB 32 KB cartridge
195 6 Two chip 16 KB 5200 cartridge
196 7 Bounty Bob Strikes Back 40 KB 5200 cartridge
197 8 64 KB Williams cartridge
198 9 Express 64 KB cartridge
199 10 Diamond 64 KB cartridge
200 11 SpartaDos X 64 KB cartridge
201 12 XEGS 32 KB cartridge
202 13 XEGS 64 KB cartridge (banks 0-7)
203 14 XEGS 128 KB cartridge
204 15 OSS one chip 16 KB cartridge
205 16 One chip 16 KB 5200 cartridge
206 17 Decoded Atrax 128 KB cartridge
207 18 Bounty Bob Strikes Back 40 KB cartridge
208 19 Standard 8 KB 5200 cartridge
209 20 Standard 4 KB 5200 cartridge
210 21 Right slot 8 KB cartridge
211 22 32 KB Williams cartridge
212 23 XEGS 256 KB cartridge
213 24 XEGS 512 KB cartridge
214 25 XEGS 1 MB cartridge
215 26 MegaCart 16 KB cartridge
216 27 MegaCart 32 KB cartridge
217 28 MegaCart 64 KB cartridge
218 29 MegaCart 128 KB cartridge
219 30 MegaCart 256 KB cartridge
220 31 MegaCart 512 KB cartridge
221 32 MegaCart 1 MB cartridge
222 33 Switchable XEGS 32 KB cartridge
223 34 Switchable XEGS 64 KB cartridge
224 35 Switchable XEGS 128 KB cartridge
225 36 Switchable XEGS 256 KB cartridge
226 37 Switchable XEGS 512 KB cartridge
227 38 Switchable XEGS 1 MB cartridge
228 39 Phoenix 8 KB cartridge
229 40 Blizzard 16 KB cartridge
230 41 Atarimax 128 KB Flash cartridge
231 42 Atarimax 1 MB Flash cartridge (old)
232 43 SpartaDos X 128 KB cartridge
233 44 OSS 8 KB cartridge
234 45 OSS two chip 16 KB cartridge (043M)
235 46 Blizzard 4 KB cartridge
236 47 AST 32 KB cartridge
237 48 Atrax SDX 64 KB cartridge
238 49 Atrax SDX 128 KB cartridge
239 50 Turbosoft 64 KB cartridge
240 51 Turbosoft 128 KB cartridge
241 52 Ultracart 32 KB cartridge
242 53 Low bank 8 KB cartridge
243 54 SIC! 128 KB cartridge
244 55 SIC! 256 KB cartridge
245 56 SIC! 512 KB cartridge
246 57 Standard 2 KB cartridge
247 58 Standard 4 KB cartridge
248 59 Right slot 4 KB cartridge
249 60 Blizzard 32 KB cartridge
250 61 MegaMax 2 MB cartridge
251 62 The!Cart 128 MB cartridge
252 63 Flash MegaCart 4 MB cartridge
253 64 MegaCart 2 MB cartridge
254 65 The!Cart 32 MB cartridge
255 66 The!Cart 64 MB cartridge
256 67 XEGS 64 KB cartridge (banks 8-15)
257 68 Atrax 128 KB cartridge
258 69 aDawliah 32 KB cartridge
259 70 aDawliah 64 KB cartridge
260 71 Super Cart 64 KB 5200 cartridge (32K banks)
261 72 Super Cart 128 KB 5200 cartridge (32K banks)
262 73 Super Cart 256 KB 5200 cartridge (32K banks)
263 74 Super Cart 512 KB 5200 cartridge (32K banks)
264 75 Atarimax 1 MB Flash cartridge (new)
265 If this option is not given, the user will be asked to choose
267 the cartridge type when the emulator starts.
268 -cart2 filename
270 Insert piggyback cartridge (CART or raw format). This works
271 only if the first cartridge is a pass-through (currently only
272 SpartaDOS X 64KB and 128KB types).
273 -cart2-type 0..75
275 Select type of the cartridge inserted with the -cart2 option.
276 When inserting a raw ROM image its type cannot be detected auto‐
277 matically, and must be provided with this option. The available
278 values are the same as for the -cart-type option above.
279 -cart-autoreboot
281 Automatically reboot after cartridge inserting/removing (this is
282 the default setting). This does not apply to the piggyback car‐
283 tridge - inserting or removing it never causes automatic reboot.
284 -no-cart-autoreboot
286 Disable automatic reboot after cartridge inserting/removing.
287 -run filename
290 Run Atari program (EXE, COM, XEX, BAS, LST)
291 -state filename
293 Load saved-state file
294 -tape filename
296 Attach cassette image (CAS format or raw file)
297 -boottape filename
299 Attach cassette image and boot it
300 -tape-readonly
302 Set the attached cassette image as read-only.
303 -1400 Emulate the Atari 1400XL
307 -xld Emulate the Atari 1450XLD
309 -bb Emulate the CSS Black Box
311 -mio Emulate the ICD MIO board
313 -nopatch
316 Normally the OS is patched giving very fast I/O. This options
317 prevents the patch from being applied so that the OS accesses
318 the serial port hardware directly. This option will probably
319 never be needed since programs that access the serial hardware
320 should work even if the OS has been patched.
321 -nopatchall
323 Don't patch OS at all, H:, P: and R: devices won't work
324 -H1 path
327 Set path for H1: device
328 -H2 path
330 Set path for H2: device
331 -H3 path
333 Set path for H3: device
334 -H4 path
336 Set path for H4: device
337 -Hpath path
339 Set path for Atari executables on the H: device
340 -hreadonly
342 Enable read-only mode for H: device
343 -hreadwrite
345 Disable read-only mode for H: device
346 -devbug
348 Put debugging messages for H: and P: devices in log file
349 -rtime Enable R-Time 8 emulation
352 -nortime
354 Disable R-Time 8 emulation
355 -rdevice [dev]
358 Enable R: device. If dev is specified then it's used as host
359 serial device name (e.g. /dev/ttyS0 on linux). If there is no
360 dev specified then R: is directed to network.
361 -mouse off
364 Do not use mouse
365 -mouse pad
367 Emulate paddles
368 -mouse touch
370 Emulate Atari Touch Tablet
371 -mouse koala
373 Emulate Koala Pad
374 -mouse pen
376 Emulate Light Pen
377 -mouse gun
379 Emulate Light Gun
380 -mouse amiga
382 Emulate Amiga mouse
383 -mouse st
385 Emulate Atari ST mouse
386 -mouse trak
388 Emulate Atari Trak-Ball
389 -mouse joy
391 Emulate joystick using mouse
392 -mouseport num
394 Set mouse port 1-4 (default 1)
395 -mousespeed num
397 Set mouse speed 1-9 (default 3)
398 -multijoy
400 Emulate MultiJoy4 interface
401 -directmouse
403 Use mouse's absolute position
404 -cx85 num
406 Emulate CX85 numeric keypad on port num
407 -grabmouse
409 SDL only, prevent mouse pointer from leaving the window
410 -record filename
413 Record all input events to filename. Can be used for gaming con‐
414 tests (highest score etc).
415 -playback filename
417 Playback input events from filename. Watch an expert play the
418 game.
419 -refresh
422 Controls screen refresh rate. A numerical value follows this
423 option which specifies how many emulated screen updates are re‐
424 quired before the actual screen is updated. This value effects
425 the speed of the emulation: A higher value results in faster CPU
426 emulation but a less frequently updated screen.
427 -ntsc-artif mode, -pal-artif mode
430 Set emulation mode of video artifacts in NTSC or PAL, respec‐
431 tively. The available values for mode are:
432 none Disable video artifacts.
433 ntsc-old
434 Simple emulation of NTSC composite video artifacts. Fast
435 but inaccurate.
436 ntsc-new
437 Improved emulation of NTSC artifacts. May look better
438 than ntsc-old.
439 ntsc-full
440 Full emulation of NTSC artifacts. Rather slow and avail‐
441 able only in 16- and 32-bit video modes.
442 pal-simple
443 Simple emulation of PAL chroma blending, without compos‐
444 ite artifacts. Fast but inaccurate.
445 pal-blend
446 Accurate emulation of PAL chroma blending, without com‐
447 posite artifacts. Available only in 16- and 32-bit video
448 modes.
449 -artif mode
451 Set artifacting mode 0-4 (0 = disable). Only for tv effects
452 ntsc-old and ntsc-new.
453 -colors-preset standard|deep-black|vibrant
456 Use one of predefined colour adjustments
457 -saturation n
459 Set screen color saturation (like TV Colour control)
460 -ntsc-saturation n, -pal-saturation n
462 Set saturation only for NTSC or PAL, respectively
463 -contrast n
465 Set screen contrast (also called white level)
466 -ntsc-contrast n, -pal-contrast -fIn
468 Set contrast only for NTSC or PAL, respectively
469 -brightness n
471 Set screen brightness (also called black level)
472 -ntsc-brightness n, -pal-brightness n
474 Set brightness only for NTSC or PAL, respectively
475 -gamma n
477 Set screen gamma correction
478 -ntsc-gamma n, -pal-gamma n
480 Set gamma adjustment only for NTSC or PAL, respectively
481 -tint n
483 Set tint -1..1.
484 -ntsc-tint n, -pal-tint n
486 Set tint only for NTSC or PAL, respectively
487 -ntsc-colordelay n
489 Set GTIA color delay for NTSC system. This emulates adjusting
490 the potentiometer existing at the bottom of Atari computers,
491 which adjusts hues of colors produced by the computer.
492 -pal-colordelay n
494 Set GTIA color delay for PAL system.
495 -paletten filename, -palettep filename
498 Read Atari NTSC/PAL colors from ACT file
499 -paletten-adjust, -palettep-adjust
501 Apply colour adjustments (brightness, contrast etc.) to the
502 loaded NTSC/PAL palette (by default the loaded palette is dis‐
503 played unmodified).
504 -screenshots pattern
507 Set filename pattern for screenshots. Use to override the de‐
508 fault pattern of atari###.png which produces atari000.png,
509 atari001.png etc. filenames. Hashes are replaced with raising
510 numbers. Existing files are overwritten only if all the files
511 defined by the pattern exist.
512 -showspeed
515 Show percentage of actual speed
516 -sound Enable sound
519 -nosound
521 Disable sound
522 -dsprate freq
524 Set sound output frequency in Hz. The default is 44100 Hz.
525 -stereo
527 Enable stereo sound
528 -nostereo
530 Disable stereo sound
531 -audio16
533 Set sound output format to 16-bit
534 -audio8
536 Set sound output format to 8-bit
537 -aname pattern
539 Set filename pattern for audio recordings. Use to override the
540 default pattern of atari###.wav which produces atari000.wav,
541 atari001.wav etc. filenames. Hashes are replaced with raising
542 numbers.
543 Note that WAV format files can support all audio codecs, includ‐
545 ing MP3, but many programs assume WAV files contain only PCM au‐
546 dio.
547 If MP3 support was enabled when compiling the emulator, and MP3
549 audio is selected using the -acodec mp3 option below, the de‐
550 fault pattern will be atari###.mp3 to save in MP3 format files.
551 -acodec auto|pcm|mp3|mulaw|pcm_mulaw|adpcm|adpcm_ima_wav|adpcm_ya‐
553 hama|adpcm_ms
554 Select the audio codec used when saving to AVI or WAV files.
555 Some codecs are lossy, meaning they reduce storage space while
556 attempting to sound as close as possible to the original audio.
557 auto The default. Use the codec that provides the best audio
560 quality, which is PCM.
561 pcm Use uncompressed pulse-code modulated (PCM) samples.
562 Lossless. Produces very large audio files.
563 mp3 Use MP3 encoding. Lossy; only available with 16-bit au‐
564 dio, and provides the best possible quality of all the
565 lossy codecs while also using the least storage space.
566 This codec is only available if MP3 support is enabled
567 when compiling the emulator.
568 mulaw Use mu-law encoding. Lossy; only available with 16-bit
569 audio, and provides 2x reduction in size from PCM sam‐
570 ples. Comparible acoustic quality to a 192kbps MP3 file.
571 pcm_mulaw
572 Sames as mulaw, included to match ffmpeg codec name.
573 adpcm Use the best adaptive dynamic pulse-code modulated (AD‐
574 PCM) codec. Lossy; all ADCPM codecs provide 4x reduction
575 in size over PCM samples. Comparible acoustic quality to
576 a 64kbps MP3 file.
577 adpcm_ima_wav
578 Use the DVI IMA ADPCM algorithm. This seems to perform
579 better on POKEY waveforms than other ADPCM algorithms and
580 will be used when adpcm is selected.
581 adpcm_yamaha
582 Use the Yamaha ADPCM algorithm.
583 adpcm_ms
584 Use the Microsoft ADPCM algorithm.
585 -ab kbps
587 Set the bitrate in kbps of the MP3 codec. The default is 128,
588 and can range between 8 and 320. Higher numbers mean better
589 quality at the cost of increased file size.
590 -ar freq
592 Set the output sample rate in Hz of the MP3 codec. The default
593 is the same sample rate as set by the -dsprate option. Only a
594 limited set of choices are available: 8000, 11025, 12000, 16000,
595 22050, 24000, 32000, 44100 and 48000. As with bitrate, higher
596 numbers mean better quality and larger files.
597 -aq num
599 Set the MP3 audio compression algorithm quality 0-9 (default 4).
600 0 means reduced quality but fast, 9 uses the slowest algorithms
601 to try to increase quality. Does not affect storage space.
602 -snd-buflen ms
604 Set length of the hardware sound buffer in milliseconds. Set‐
605 ting to 0 (the default) causes the length to be set automati‐
606 cally. Higher values increase sound latency. Automatic setting
607 should be OK in most cases.
608 -snddelay ms
610 Set sound latency in milliseconds. Increase it if you experi‐
611 ence gaps of silence during sound playback.
612 -vname pattern
615 Set filename pattern for video recordings. Use to override the
616 default pattern of atari###.avi which produces atari000.avi,
617 atari001.avi etc. filenames. Hashes are replaced with raising
618 numbers.
619 -vcodec auto|rle|msrle|png|zmbv|uzmbv
621 Select the video codec used to store image frames in AVI video
622 recordings. All video codecs use lossless compression.
623 auto The default. Use the codec that provides the best aver‐
625 age compression ratio which is zmbv if available, other‐
626 wise rle.
627 rle Use run-length encoding (RLE) for very good compression
628 of video frames. This codec is always available.
629 msrle Sames as rle, included to match ffmpeg codec name.
630 png Use PNG image compression for moderate compression of
631 video frames. This codec is only available if PNG support
632 was compiled into the emulator.
633 zmbv Use Zip Motion Blocks Video (ZMBV) for the best compres‐
634 sion of video frames. This codec is only available if
635 support for the zlib compression library was compiled
636 into the emulator.
637 uzmbv Uncompressed Zip Motion Blocks Video is only available
638 when compiled without the zlib compression library.
639 -showstats
641 Show elapsed recording time and file size on screen during
642 recording of video or audio.
643 -no-showstats
645 Don't show multimedia statistics during recording of video or
646 audio
647 -keyint num
649 Set the keyframe interval to one keyframe every num frames (de‐
650 fault is 50 for PAL, 60 for NTSC). The RLE and ZMBV codecs use
651 keyframes and inter-frames, which encode full frames and differ‐
652 ences between frames, respectively. Inter-frames are typically
653 much smaller than full frames, but most video players can only
654 seek to keyframes.
655 -compression-level num
657 Set compression level 0-9 (default 6) PNG or zlib compression
658 used in the emulator. Zero means no compression and larger num‐
659 bers correspond to higher compression and smaller image sizes,
660 at the cost of increased time to generate the compressed image.
661 This affects both screenshots and the video codec.
662 Curses Options
666 -left Use columns 0 to 39
667 -central
669 Use columns 20 to 59
670 -right Use columns 40 to 79
672 -wide1 Use columns 0 to 79. In this mode only the even character posi‐
674 tions are used. The odd locations are filled with spaces.
675 -wide2 Use columns 0 to 79. This mode is similar to -wide1 except that
677 the spaces are in reverse video if the previous character was
678 also in reverse video.
679 Falcon Options
682 -interlace x
683 Generate Falcon screen only every x frame
684 -videl Direct VIDEL programming (Falcon/VGA only)
686 -double
688 Double the screen size on NOVA
689 -delta Delta screen output (differences only)
691 -joyswap
693 Swap joysticks
694 Java NestedVM Options
697 -scale n
698 Scale width and height by n
699 SDL Options
702 -fullscreen
703 Start in fullscreen mode. The default resolution is 336x240 and
704 can be later changed.
705 -windowed
707 Start in a window (the default).
708 -rotate90
710 Rotate display (useful for devices with 240x320 screen).
711 -no-rotate90
713 Don't rotate display (the default).
714 -fs-width number-of-pixels
716 Host horizontal resolution for fullscreen.
717 -fs-height number-of-pixels
719 Host vertical resolution for fullscreen.
720 -win-width number-of-pixels
722 Set horizontal size of the window. The window can be later re‐
723 sized manually.
724 -win-height number-of-pixels
726 Set vertical size of the window. The window can be later re‐
727 sized nanually.
728 -bpp number-of-bits
730 Sets image color depth when OpenGL acceleration is disabled.
731 Accepted values are: 0 (use desktop depth; this is the default),
732 8, 16 and 32. Depending on the type of graphics hardware, the
733 fullscreen setting and current desktop bit depth, either of the
734 values might give the best performance. Note that with bit
735 depth set to 16 emulation of colors is slightly less accurate.
736 -vsync Synchronize the display with the monitor's vertical retrace, to
738 remove image tearing artifacts. This improves display quality,
739 but may be not available depending on the current wideo mode
740 (fullscreen/windowed), the chosen SDL_VIDEODRIVER and type of
741 graphics hardware. Synchronization is available for some SDL
742 videodrivers (directx, dga) but not for others. In OpenGL this
743 option has no effect - vertical synchronization must be instead
744 enabled in the video hardware driver's settings, if available.
745 -no-vsync
747 Disable synchronization with monitor's vertical retrace (the de‐
748 fault).
749 -horiz-area narrow|tv|full|number
751 Set amount of visible screen horizontally:
752 narrow Shows 320 pixels.
754 tv The default. Shows area visible on a standard TV (336
755 pixels).
756 full Shows full overscan area (384 pixels).
757 number An exact horizontal size can be set by providing a number
758 between 160 and 384.
759 -vertical-area short|tv|full|number
761 Set amount of visible screen vertically:
762 short Shows 200 pixels.
764 tv The default. Shows area visible on a typical TV (224 or
765 240 pixels, depending on current TV system).
766 full Shows full overscan area, which can be up to 300 pixels
767 in case of the XEP80.
768 number An exact number of visible scanlines can be set by pro‐
769 viding a number between 100 and 300.
770 Note that when displaying output of an XEP80 or Austin Franklin
772 80 column card, the tv setting will crop the top and bottom
773 parts of text area, just like a real TV does - in such case set‐
774 ting the option to full would be more appriopriate.
775 -horiz-shift number
777 When the visible horizontal area is not set to full, this option
778 specifies the screen's area that will be visible. Values higher
779 than 0 will cause showing more of the right side of the screen,
780 while values lower than 0 will cause showing more of the left
781 side. The default is 0 (no shift). -vert-shift number Analogi‐
782 cally to -horiz-shift: when the visible vertical area is not set
783 to full, this option specifies the screen's area that will be
784 visible. Values higher than 0 will cause showing more of the
785 bottom part of the screen, while values lower than 0 will cause
786 showing more of the top part. The default is 0 (no shift).
787 -stretch none|integral|full|number
789 Choose method of stretching the image to fit the screen/window
790 area:
791 none The image won't be stretched at all.
793 integral
794 The default. The image will fit the screen/window but
795 will be stretched only by an integral multiplier. This
796 setting allows for nice output when using scanlines in
797 low screen resolutions.
798 full The screen will fit the entire screen/window area. This
799 setting looks best in high screen resolutions.
800 number A custom multiplier (floating point number) can be also
801 provided to precisely set the amount of stretching.
802 -fit-screen width|heightWhen -stretch is set to integral or full, this
804 parameter
805 controls how the stretching is performed with relation to win‐
806 dow/screen size:
807 width Fits the image's width while allowing it to be cropped
809 vertically.
810 height Fits the image's height while allowing it to be cropped
811 horizontally.
812 both The default. Fit both the image's width and height,
813 avoiding cropping.
814 -image-aspect none|square-pixels|real
816 Choose how the image's aspect ratio should be maintained when
817 stretching:
818 none Causes the image to be stretched without restriction to
820 fit the screen/window area fully.
821 square-pixels
822 The default. Causes the image to be stretched by the
823 same amount horizontally and vertically, maintaining
824 square pixels. In low screen resolutions this setting
825 may produce the nicest result.
826 real Recreates the aspect ratio of a real TV display (pixels
827 are not square), but only if the -host-aspect-ratio op‐
828 tion is set correctly.
829 -host-aspect-ratio auto|x:y
831 Set the aspect ratio of the host monitor on which the emulator's
832 display is placed. Allowed values are auto for autodetection,
833 or ratios like 4:3, 16:9, 1.25:1 ... This value is used to
834 properly maintain image's aspect ratio when having -image-aspect
835 set to real. The default value is auto. Note that host aspect
836 ratio detection works as expected only if the desktop resolution
837 matches aspect ratio of the display device (in other words, dis‐
838 play pixels are square). If, for example, desktop resolution is
839 800x600 on a 16:9 monitor, autodetection will fail and host as‐
840 pect ratio will have to be set manually, by measuring physical
841 width and height of the monitor and setting the parameter to
842 width:height.
843 -80column
845 Shows output of an 80 column hardware, when it is available (the
846 default). This parameter has effect only if an 80 column hard‐
847 ware is activated, using one of the parameters -af80, -proto80
848 or -af80.
849 -no-80column
851 Deactivates showing output of an 80 column hardware.
852 -nojoystick
856 Do not initialize SDL joysticks
857 -joy0hat
859 Use hat of joystick 0 rather than the axis for joystick move‐
860 ment.
861 -joy1hat
863 Use hat of joystick 1 rather than the axis for joystick move‐
864 ment.
865 -joy2hat
867 Use hat of joystick 2 rather than the axis for joystick move‐
868 ment.
869 -joy3hat
871 Use hat of joystick 3 rather than the axis for joystick move‐
872 ment.
873 -joy0 path-to-device
875 Define path to device used in LPTjoy 0. Available on linux-ia32
876 only.
877 -joy1 path-to-device
879 Define path to device used in LPTjoy 1. Available on linux-ia32
880 only.
881 -ntsc-filter-preset composite|svideo|rgb|monochrome
884 Use one of predefined NTSC filter adjustments.
885 -ntsc-sharpness n
887 Set sharpness of the NTSC filter.
888 -ntsc-resolution n
890 Set resolution of the NTSC filter.
891 -ntsc-artifacts n
893 Set artifacts of the NTSC filter.
894 -ntsc-fringing n
896 Set fringing of the NTSC filter.
897 -ntsc-bleed n
899 Set bleed of the NTSC filter.
900 -ntsc-burstphase n
902 Set burst phase of the NTSC filter. This changes colors of ar‐
903 tifacts. The best values are 0, 0.5, 1, 1.5.
904 -scanlines n
906 Set visibility of scanlines (0..100). Scanlines are only visi‐
907 ble when the screen's or window's vertical size is at least 480
908 (more precisely, at least twice the number of scanlines given in
909 -vert-area).
910 -scanlinesint
912 Enable scanlines interpolation (looks nicer).
913 -no-scanlinesint
915 Disable scanlines interpolation (in software modes may give bet‐
916 ter performance).
917 -video-accel
919 Use OpenGL hardware acceleration for displaying and stretching
920 of the emulator's display. Using OpenGL improves performance.
921 -no-video-accel
923 Don't use OpenGL hardware acceleration (the default).
924 -pixel-format bgr16|rgb16|bgra32|argb32
926 Choose format of texture data when OpenGL acceleration is en‐
927 abled. Depending on the type of the graphics hardware, either
928 of the values might give the best performance. Note that with
929 pixel format set to bgr16 or rgb16, emulation of colors is
930 slightly less accurate.
931 -pbo Use Pixel Buffer Objects when OpenGL acceleration is enabled
933 (the default). PBOs are available on newer graphics hardware
934 and when used, substantially improve emulator's performance.
935 However in rare cases (some Intel on-board chips) using PBOs may
936 actually descrease perfromance.
937 -no-pbo
939 Don't use Pixel Buffer Objects when OpenGL acceleration is used.
940 -bilinear-filter
942 Enable bilinear filtering of the screen in OpenGL modes.
943 -no-bilinear-filter
945 Disable bilinear filtering in OpenGL modes (the default).
946 -opengl-lib path
948 Provide a custom OpenGL shared library. If not given, Atari800
949 will use a default system-specific library (typically
950 opengl32.dll or libGL.so).
951 -proto80
953 Emulate a prototype 80 column board for the 1090
954 -xep80 Emulate the XEP80
956 -xep80port n
958 Use XEP80 on joystick port n
959 -af80 Emulate the Austin Franklin 80 column daughterboard for Atari
961 800.
962 -volume 0..100
964 Sets global volume of Atari 800.
965 X11 Options
969 -small Run the emulator in a small window where each Atari 800 pixel is
970 represented by one X Window pixel
971 -large Runs the emulator in a large window where each Atari 800 pixel
973 is represented by a 2x2 X Window rectangle. This mode is se‐
974 lected by default.
975 -huge Runs the emulator in a huge window where each Atari 800 pixel is
977 represented by a 3x3 X Window rectangle.
978 -clip_x number-of-pixels
980 Set left offset for clipping
981 -clip_width number-of-pixels
983 Set the width of the clipping-area
984 -clip_y number-of-pixels
986 Set top offset for clipping
987 -clip_height number-of-pixels
989 Set the height of the clipping-area
990 -private_cmap
992 Use private colormap
993 -sio Show SIO monitor
995 -x11bug
997 Enable debug code in atari_x11.c
998 -keypad
1001 Keypad mode
1002
1005 F1 Built in user interface
1006 F2 Option key
1007 F3 Select key
1008 F4 Start key
1009 F5 Reset key ("warm reset")
1010 Shift+F5 Reboot ("cold reset")
1011 F6 Help key (XL/XE only)
1012 F7 Break key
1013 F8 Enter monitor
1014 F9 Exit emulator
1015 F10 Save screenshot
1016 Shift+F10 Save interlaced screenshot
1017 Alt+R Run Atari program
1018 Alt+D Disk management
1019 Alt+C Cartridge management
1020 Alt+Y Select system
1021 Alt+O Sound settings
1022 Alt+W Sound recording start/stop
1023 Alt+V Video recording start/stop
1024 Alt+S Save state file
1025 Alt+L Load state file
1026 Alt+A About the emulator
1027 Insert Insert line (Atari Shift+'>')
1028 Ctrl+Insert Insert character (Atari Ctrl+'>')
1029 Shift+Ctrl+Insert Shift+Ctrl+'>'
1030 Delete Delete line (Atari Shift+Backspace)
1031 Shift+Backspace Delete line (Atari Shift+Backspace)
1032 Ctrl+Delete Delete character (Atari Ctrl+Backspace)
1033 Ctrl+Backspace Delete character (Atari Ctrl+Backspace)
1034 Shift+Ctrl+Delete Shift+Ctrl+Backspace
1035 Shift+Ctrl+Backspace Shift+Ctrl+Backspace
1036 Home Clear (Atari Shift+'<')
1037 Ctrl+Home Ctrl+'<' (also clears screen)
1038 Shift+Ctrl+Home Shift+Ctrl+'<'
1039 ~ Inverse video
1040 Up Up (Atari Ctrl+'-')
1041 Down Down (Atari Ctrl+'=')
1042 Left Left (Atari ctrl+'+')
1043 Right Right (Atari ctrl+'*')
1044 Ctrl+Up -
1045 Ctrl+Down =
1046 Ctrl+Left +
1047 Ctrl+Right *
1048 Shift+Up _ (Atari Shift+'-')
1049 Shift+Down | (Atari Shift+'=')
1050 Shift+Left (Atari Shift+'+')
1051 Shift+Right ^ (Atari Shift+'*')
1052 Shift+Ctrl+Up Shift+Ctrl+-
1053 Shift+Ctrl+Down Shift+Ctrl+=
1054 Ctrl+\ Ctrl+Esc (Workaround for Windows)
1055 Shift+Ctrl+\ Shift+Ctrl+Esc (Workaround for Windows)
1056 CX85 Keypad (if enabled):
1058 host keypad 0123456789-. 0123456789-.
1059 host keypad NO
1060 host keypad Ctrl+/ ESCAPE
1061 host keypad * DELETE
1062 host keypad + YES
1063 host keypad Enter +ENTER
1064 Paddles, Atari touch tablet, Koala pad, light pen, light gun, ST/Amiga
1066 mouse, Atari trak-ball, joystick and Atari 5200 analog controller are
1067 emulated using mouse on ports that support it. See the options above
1068 for how to enable mouse.
1069 Basic
1071 No function keys or Alt+letter shortcuts. Use Ctrl+C to enter the mon‐
1072 itor. Controllers not supported in this version.
1073 Curses
1075 F10 (Save screenshot) does not work in the default CURSES_BASIC build.
1076 Shift+F5 and Shift+F10 don't work at all. Avoid Ctrl + C, H, J, M, Q,
1077 S and Z. The remaining control characters can be typed. Control char‐
1078 acters are displayed on the screen with the associated upper case char‐
1079 acter in bold.
1080 Controllers not supported in this version.
1082 Falcon
1084 Help Help key (XL/XE)
1085 Joystick 0 is operated by the numeric keypad (make sure that the nu‐
1087 meric keypad has been enabled).
1088 7 8 9
1090 \|/
1091 4 5 6
1092 /|\
1093 1 2 3
1094 And 0 is the fire key.
1096 Mouse not supported in this version.
1098 SDL
1100 ` Atari/Inverse key
1101 LSUPER Atari/Inverse key (unusable under Windows)
1102 RSUPER CapsToggle (+Shift = CapsLock)
1103 LAlt+F Switch fullscreen/windowed display.
1105 LAlt+G Switch visible horizontal area. See -horiz-area.
1106 LAlt+J Swap keyboard_emulated joysticks
1107 LAlt+M Grab mouse (prevents mouse pointer from leaving the win‐
1108 dow)
1109 LAlt+LShift+1 Decrease tint (also called hue)
1111 LAlt+1 Increase hue
1112 LAlt+LShift+2 Decrease saturation (like TV Colour control)
1113 LAlt+2 Increase saturation
1114 LAlt+LShift+3 Decrease contrast (also called white level)
1115 LAlt+3 Increase contrast
1116 LAlt+LShift+4 Decrease brightness (also called black level)
1117 LAlt+4 Increase brightness
1118 LAlt+LShift+5 Decrease gamma adjustment
1119 LAlt+5 Increase gamma adjustment
1120 LAlt+LShift+6 Decrease color delay (Atari color adjustment potentiome‐
1121 ter)
1122 LAlt+6 Increase color delay
1123 The following keys work only when the NTSC filter is enabled (-ntsc-ar‐
1125 tif set to ntsc-full):
1126 LAlt+LShift+7 Decrease sharpness
1127 LAlt+7 Increase sharpness
1128 LAlt+LShift+8 Decrease resolution
1129 LAlt+8 Increase resolution
1130 LAlt+LShift+9 Decrease artifacts
1131 LAlt+9 Increase artifacts
1132 LAlt+LShift+0 Decrease fringing
1133 LAlt+0 Increase fringing
1134 LAlt+LShift+- Decrease bleed
1135 LAlt+- Increase bleed
1136 LAlt+LShift+= Decrease NTSC burst phase (use this to change ar‐
1137 tifacting colours)
1138 LAlt+= Increase NTSC burst phase
1139 LAlt+LShift+[ Decrease scanlines visibility
1141 LAlt+[ Increase scanlines visibility
1142 LAlt+] Toggle NTSC composite/S-Video/RGB/monochrome settings
1143 LAlt+Shift+X Enable/disable output of a 80 column hardware (use with
1146 -xep80, -proto80 or -af80).
1147 Apart from standard joysticks (handled by the SDL) up to two keyboard
1150 joysticks are supported. The keys used for joystick directions and the
1151 trigger can be freely defined in the config UI (Controller Config ->
1152 Define layout). Keyboard joystick emulation can be enabled/disabled in
1153 the Controller Config. By default, joy 0 is enabled and joy 1 is dis‐
1154 abled (to not steal normal AWDS keys in the emulator).
1155 X11
1157 Alt Atari key (either Alt key will work)
1158 Joystick 0 is operated by the mouse position relative to the center of
1160 the screen. The mouse button acts as the trigger. On Linux, standard
1161 joysticks are also supported.
1162
1165 Audio can be recorded to WAV format sound files or as the audio track
1166 of AVI format multimedia files (described in the next section). A
1167 choice of audio codecs is available, some using lossy compression to
1168 reduce file size as compared to uncompressed audio. All lossy codecs
1169 require 16 bit sample sizes using the -audio16 option.
1170 The term "lossy" means the recorded sound is not bit-for-bit identical
1172 to the output of the emulator. Each codec provides a different method
1173 to reduce size, possibly reducing the audio quality. In practice, the
1174 audio produced by these codecs is not perceptibly worse than lossless
1175 encoding when using sample rates of 44.1kHz or 48kHz. However, the pos‐
1176 sibility exists that recompressing lossy audio (for instance by upload‐
1177 ing to YouTube) could reduce quality.
1178 The only lossless codec provided is the pulse-code modulation (PCM)
1180 codec, which simply stores the raw data generated by the POKEY emula‐
1181 tion. This takes the most space of any codec, but provides the best
1182 possible audio quality. The sample size is specified by the -audio16 or
1183 -audio8 options. This is the recommended codec unless extremely long
1184 recording times are desired. See the tables in the VIDEO RECORDING sec‐
1185 tion below.
1186 The MP3 codec is the best choice of a lossy codec, as paramaters can be
1188 tuned to generate high quality audio for different situations. An audio
1189 bitrate of 128kbps (the -ab 128 option) results in high quality audio
1190 at about an 8x reduction in storage space over PCM audio. The MP3 codec
1191 is a compile-time option, and will be included automatically if the
1192 libmp3lame library is found during compilation.
1193 The remaining lossy codecs should not be considered unless the MP3
1195 codec is not available. In most cases they produce reasonable quality,
1196 without many audible artifacts to the casual listener. But the algo‐
1197 rithms were originally designed for compressing speech over telephone
1198 lines and they can produce audio distortion in some instances.
1199 The mu-law codec uses a logarithmic scale to convert 16 bit samples
1201 into 8 bits of data, resulting in half the size of 16 bit PCM audio.
1202 This codec does not work with 8 bit audio. Waveform analysis shows the
1203 acoustic quality is similar to a 192kbps MP3 file, although the MP3 is
1204 half the size. Surprisingly, in many cases the acoustic quality of mu-
1205 law can be better than 8 bit PCM samples even though it takes the same
1206 storage space.
1207 Adaptive differential pulse-code modulation (ADPCM) encodes differences
1209 between successive 16 bit audio samples into 4 bits, therefore the out‐
1210 put is one quarter of the size of the PCM codec. The acoustic quality
1211 is similar to a 64kbps MP3 file, although the MP3 is 3x smaller. Audio
1212 distortio may be audible under certain conditions, like high volume
1213 square waves.
1214
1216 atari800 is capable of recording the emulated video and audio to AVI
1217 format multimedia files. A choice of lossless video codecs is avail‐
1218 able, while audio is stored with any of the lossless or lossy codecs as
1219 described above. To record without sound, specify the -nosound option.
1220 The most efficient video codec is the Zip Motion Block Video (ZMBV)
1222 codec. This codec uses keyframes and inter-frames, and achieves its
1223 high compression because inter-frames use motion estimation when calcu‐
1224 lating differences to the previous frame. It is a compile-time option
1225 when building the emulator, and is the default if available. There is
1226 an uncompressed variant that is available when compiled without zlib;
1227 see the note below.
1228 The Run-Length Encoding (RLE) video codec also uses keyframes and in‐
1230 ter-frames. Its inter-frame compression is not as efficient as ZMBV,
1231 but still produces high compression in cases where only small parts of
1232 the screen change between frames. This codec is always available and
1233 is the default if compressed ZMBV is not available.
1234 The PNG video codec has moderate compression because it uses only
1236 keyframes. It is useful in certain cases if the ZMBV codec is not
1237 available. It is a compile-time option when building the emulator.
1238 Uncompressed ZMBV is typically inferior to RLE and PNG and is not rec‐
1240 ommended in general. There are a few limited instances (like detailed
1241 scrolling backgrounds) where uncompressed ZMBV will outperform RLE or
1242 PNG, and for that reason it is made available as the uzmbv codec when
1243 compiled without zlib. For testing purposes when compiled with zlib,
1244 uncompressed ZMBV video can be generated with the -compression-level 0
1245 command line argument.
1246 Video Support:
1248 ┌─────────────────────┬────────────┬─────────────┬───────────────────────┐
1250 │Application │ Type │ Platform │ RLE PNG ZMBV │
1251 ├─────────────────────┼────────────┼─────────────┼───────────────────────┤
1252 │YouTube │ Website │ Browser │ Yes Yes Yes │
1253 │Twitter │ Website │ Browser │ No[1] No[1] No[1] │
1254 │FFmpeg │ Transcoder │ Win/Mac/Lin │ Yes Yes Yes │
1255 │Handbrake │ Transcoder │ Win/Mac/Lin │ Yes Yes Yes │
1256 │VLC │ Player │ Win/Mac/Lin │ Yes No[2] Yes │
1257 │Windows Media Player │ Player │ Windows │ Yes No No │
1258 │Win 10 Movies & TV │ Player │ Windows │ No No No │
1259 │IINA │ Player │ Mac │ Yes Yes Yes │
1260 │QuickTime │ Player │ Mac │ No No No │
1261 │Totem (Gnome Videos) │ Player │ Linux │ No Yes Yes │
1262 │MPV (Celluloid) │ Player │ Linux │ Yes Yes Yes │
1263 │MPlayer │ Player │ Linux │ Yes Yes Yes │
1264 └─────────────────────┴────────────┴─────────────┴───────────────────────┘
1265 [1] Twitter only accepts mp4 files using the h264 video
1266 codec and the aac audio codec. The avi files produced
1267 by atari800 must be transcoded with an application like
1268 FFmpeg or Handbrake. Videos are limited to 2 minutes and
1269 20 seconds.
1270 [2] VLC recognizes and plays PNG-encoded video, but decodes the
1272 video incorrectly resulting in garbled images.
1273 Currently there is a limit of 4GB for video size. The maximum recording
1275 time for this size limit depends on many factors. Some examples can be
1276 seen in the tables below:
1277 ZMBV codec (default compression level):
1279 ┌─────────────┬─────────┬───────────────────────────────────────────────┐
1281 │ │ Average │ Estimated recording time │
1282 │ Game │ video ├───────────────────────────────────────────────┤
1283 │ │ frame │ mp3 mp3 ADPCM 8-bit 16-bit │
1284 │ │ size │ 128 kbps 320 kbps audio audio audio │
1285 ├─────────────┼─────────┼───────────────────────────────────────────────┤
1286 │ │ │ │
1287 │Jumpman │ 0.08k │ 49 hr 23 hr 38 hr 21 hr 11 hr │
1288 │Miner 2049er │ 0.13k │ 43 hr 22 hr 35 hr 20 hr 11 hr │
1289 │Alley Cat │ 0.37k │ 28 hr 17 hr 24 hr 16 hr 9h 40m │
1290 │Dropzone │ 0.82k │ 17 hr 12 hr 15 hr 11 hr 7h 55m │
1291 │AtariBlast! │ 1.2k │ 12 hr 9h 55m 11 hr 9h 30m 6h 50m │
1292 │Boulder Dash │ 0.17k │ 40 hr 21 hr 33 hr 19 hr 10 hr │
1293 └─────────────┴─────────┴───────────────────────────────────────────────┘
1294 RLE codec:
1296 ┌─────────────┬─────────┬────────────────────────────────────────────────┐
1298 │ │ Average │ Estimated recording time │
1299 │ Game │ video ├────────────────────────────────────────────────┤
1300 │ │ frame │ mp3 mp3 ADPCM 8-bit 16-bit │
1301 │ │ size │ 128 kbps 320 kbps audio audio audio │
1302 ├─────────────┼─────────┼────────────────────────────────────────────────┤
1303 │ │ │ │
1304 │Jumpman │ 0.36k │ 28 hr 17 hr 24 hr 16 hr 9h 45m │
1305 │Miner 2049er │ 0.39k │ 27 hr 17 hr 24 hr 15 hr 9h 35m │
1306 │Alley Cat │ 1.0k │ 14 hr 11 hr 13 hr 10 hr 7h 20m │
1307 │Dropzone │ 2.3k │ 7h 25m 6h 20m 7h 05m 6h 10m 4h 55m │
1308 │AtariBlast! │ 6.9k │ 2h 40m 2h 30m 2h 35m 2h 30m 2h 15m │
1309 │Boulder Dash │ 9.1k │ 2h 00m 1h 55m 2h 00m 1h 55m 1h 45m │
1310 └─────────────┴─────────┴────────────────────────────────────────────────┘
1311 PNG codec (default compression level):
1313 ┌─────────────┬─────────┬────────────────────────────────────────────────┐
1315 │ │ Average │ Estimated recording time │
1316 │ Game │ video ├────────────────────────────────────────────────┤
1317 │ │ frame │ mp3 mp3 ADPCM 8-bit 16-bit │
1318 │ │ size │ 128 kbps 320 kbps audio audio audio │
1319 ├─────────────┼─────────┼────────────────────────────────────────────────┤
1320 │ │ │ │
1321 │Jumpman │ 2.4k │ 7h 05m 6h 10m 6h 50m 5h 55m 4h 45m │
1322 │Miner 2049er │ 2.2k │ 7h 40m 6h 35m 7h 20m 6h 20m 5h 00m │
1323 │Alley Cat │ 4.1k │ 4h 20m 4h 00m 4h 15m 3h 55m 3h 20m │
1324 │Dropzone │ 2.8k │ 6h 10m 5h 25m 6h 00m 5h 20m 4h 20m │
1325 │AtariBlast! │ 4.4k │ 4h 05m 3h 45m 4h 00m 3h 40m 3h 10m │
1326 │Boulder Dash │ 4.5k │ 4h 00m 3h 40m 3h 55m 3h 35m 3h 10m │
1327 └─────────────┴─────────┴────────────────────────────────────────────────┘
1328
1331 /usr/share/atari800/ATARIOSA.ROM
1332 Atari O/S A
1333 /usr/share/atari800/ATARIOSB.ROM
1335 Atari O/S B
1336 /usr/share/atari800/ATARIXL.ROM
1338 Atari 800XL O/S
1339 /usr/share/atari800/ATARI5200.ROM
1341 Atari 5200 O/S
1342 /usr/share/atari800/ATARIBAS.ROM
1344 Atari Basic
1345
1348 See the BUGS file.
1349Atari800 5.0.0 2022-05-28 ATARI800(1)