Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
HATARI(1)							     HATARI(1)

NAME
       hatari -	Atari ST/STE/TT/Falcon emulator

SYNOPSIS
       hatari [options]	[directory|diskimage|program]

DESCRIPTION
       Hatari  is  an Atari ST/STE/TT/Falcon emulator for Linux	and other Sys-
       tems which are supported	by the SDL (cross-platform graphics, input and
       sound) library.

       With Hatari one can run games, demos or applications written for	 Atari
       ST,  STE	or Falcon.  Atari TT support is	experimental.  Hatari supports
       the commonly used *.st, *.msa and *.stx disk images, and	hard disk emu-
       lation.

       To run the emulator a TOS ROM image is needed. EmuTOS, a	free implemen-
       tation of TOS is	shipped	with Hatari. It	boots faster than original TOS
       versions	and doesn't need separate HD drivers, but  some	 buggy	(typi-
       cally  floppy  only)  programs  won't work correctly with it.  For best
       compatibility, it is recommended	to use a TOS ROM from a	real Atari.

       As an argument, one can give either a name of a directory  that	should
       be  emulated  as	 a virtual GEMDOS hard disk, a floppy disk image or an
       Atari program that should be autostarted.  In the last  case  the  pro-
       gram's  directory  will be used as the C: drive from where this program
       will be started.	 These shortcuts correspond to "-d  <dir>",  "--disk-a
       <floppy image>" and "-d <dir> --auto C:\<program>" options.

       Booting will be done from the disk image	or directory that's given last
       on the command line, either as an option	or an argument (and which cor-
       responds	to A: or C:).

OPTIONS
       Hatari options are split	into several categories:

General	options
       -h, --help
	      Print command line options and terminate

       -v, --version
	      Print version information	and terminate

       --confirm-quit <bool>
	      Whether Hatari confirms quitting

       -c, --configfile	<filename>
	      Read additional configuration values from	<file>,	these override
	      values read from the global and user configuration files

       -k, --keymap <file>
	      Load  keyboard  mapping  from <file>. "Symbolic" mapping will be
	      used as fallback for keys	not defined there

       --country <x>
	      Set EmuTOS ROM country  code  on	Mega/ST/STe  machines  lacking
	      NVRAM, when EmuTOS indicates supporting multiple ones.

	      In  512k	EmuTOS	images,	 country code selects the TOS keyboard
	      layout and screen	refresh	(US = 60Hz NTSC, 50Hz PAL  otherwise).
	      In 1024k EmuTOS images (coming with Hatari binaries and support-
	      ing multiple languages), country code selects also TOS language.

	      Alternatively,  one  can	use "tos-lang-change" tool from	EmuTOS
	      project to modify	country	code in	the  ROM  image	 file  itself.
	      That works also for TOS v4

       --layout	<x>
	      Set  NVRAM  keyboard  layout value. While	both TT	and Falcon ma-
	      chines have NVRAM, only TOS v4 and EmuTOS	512k / 1024k ROM  ver-
	      sions support multiple layouts.

	      Regardless of whether keyboard layout change is done through the
	      ROM  country  code or NVRAM setting, it may impact your key map-
	      pings in Hatari key mapping files, Hatari	Python	UI  arguments,
	      or key injection in your automation scripts for Hatari debugger,
	      command FIFO or hconsole tool

       --language <x>
	      Set NVRAM	language value.	While both TT and Falcon machines have
	      NVRAM,  only TOS v4 and EmuTOS 1024k ROM versions	support	multi-
	      ple languages.  Default is taken from the	LANG environment vari-
	      able

       --fast-forward <bool>
	      Fast-forward through the boring parts  by	 running  emulator  at
	      maximum  speed.	Done by	skipping frame update VBL waits. Upper
	      limit for	frame skipping is given	with the  --frameskips	option
	      and shown	in statusbar "FS" field

       --auto <program>
	      Autostarts  given	program, if TOS	finds it.  Program needs to be
	      given with full path it will have	under emulation,  for  example
	      "C:\DIR\PROGRAM.PRG".  This  is  implemented  by providing TOS a
	      virtual INF file for the boot drive (A: or C:), which tells  TOS
	      to start the given program

Common display options
       -m, --mono
	      Start in monochrome mode instead of color

       --monitor <x>
	      Select monitor type (x = mono/rgb/vga/tv)

       --tos-res <x>
	      Select  TOS  resolution for color	monitors (x = low/med/high/tt-
	      low/ttmed)

       -f, --fullscreen
	      Start the	emulator in fullscreen mode

       -w, --window
	      Start the	emulator in windowed mode

       --grab Grab mouse (also)	in windowed mode

       --resizable <bool>
	      Allow window resizing

       --borders <bool>
	      Show ST/STE/Falcon screen	borders	(for low/med resolution	 over-
	      scan demos)

       --frameskips <x>
	      Skip  <x>	frames after each displayed frame to accelerate	emula-
	      tion (0=disabled,	>4 uses	automatic frameskip with  given	 value
	      as maximum)

       --slowdown <x>
	      Slow  down  emulation by factor of x (used as multiplier for VBL
	      wait time)

       --mousewarp <bool>
	      To keep host mouse better	in sync	with Atari mouse pointer, cen-
	      ter it to	Hatari window on cold reset and	resolution changes

       --statusbar <bool>
	      Show statusbar (with floppy leds etc etc)

       --drive-led <bool>
	      Show overlay drive led when statusbar isn't shown

       --max-width <x>
	      Preferred	/ maximum Hatari screen	width

       --max-height <x>
	      Preferred	/ maximum Hatari screen	height.

	      Maximum width and	height options are part	of Hatari's Atari mon-
	      itor emulation. They limit the size Hatari should	 aim  for  its
	      internal	SDL framebuffer, and how much of the Atari screen bor-
	      ders are visible.

	      The framebuffer is then scaled to	the Hatari output window based
	      on the specified Hatari zoom factor (see below).

	      Aim of this is to	have all resolutions show up in	 approximately
	      same size, like on a real	Atari monitor. Hatari's	internal inte-
	      ger  scaling support sets	some limits on this, so	it's an	expert
	      option.

	      Note: Only reason	to change the  defaults,  should  be  limiting
	      this  to	a smaller resolution for performance reasons, e.g. for
	      video recording, or on really underpowered systems, to make mon-
	      itor do all of the ST-low	resolution scaling by  forcing	Hatari
	      to ask SDL for CGA / QVGA	resolution.

       -z, --zoom <x>
	      This  option overrides max width/height options so that e.g. ST-
	      low resolution gets always doubled, and all resolutions  (except
	      TT-high)	have  approximately  the same size, like on a real CRT
	      monitor.

	      Zoom factor is then used to scale	 that  up  (or	down)  to  the
	      Hatari  output  window.	This way scaling results always	in ap-
	      proximately same sized Hatari window.

	      With non-integer zoom factors, linear scaling is used to	smooth
	      out the output, with integer zoom	factors, scaling is done using
	      nearest  neighboring  pixels  for	 sharper output.  This applies
	      also to window resizes.

	      To avoid zooming of low resolutions, use "--zoom	1  --max-width
	      416  --max-height	 276" (if you don't need borders, 320x200 size
	      is enough).  Disabling low resolution doubling like this is  not
	      recommended  for Falcon emulation	because	TOS v4 bootup and some
	      demos switch resolutions frequently.

       --bpp <bool>
	      Force internal bitdepth (x = 8/15/16/32, 0=disable)

       --disable-video <bool>
	      Run emulation without displaying video (audio only)

ST/STE specific	display	options
       --spec512 <x>
	      Hatari uses this threshold to decide when	 to  render  a	screen
	      with  the	slower but more	accurate Spectrum512 screen conversion
	      functions	(0 <= x	<= 512,	0=disable)

       --video-timing <x>
	      Wakeup State  for	 MMU/GLUE  (x=ws1/ws2/ws3/ws4/random,  default
	      ws3).  When  powering  on,  the  STF will	randomly choose	one of
	      these wake up states. The	state will  then  affect  the  timings
	      where  border  removals  and  other video	tricks should be made,
	      which can	give different results on screen. For example, WS3  is
	      known  to	be compatible with many	demos, while WS1 can show more
	      problems.

TT/Falcon specific display options
       Zooming to sizes	specified below	is internally done using integer scal-
       ing factors. This means that different Atari resolutions	 may  show  up
       with different sizes, but they are never	blurry.

       --desktop <bool>
	      Whether  to use desktop resolution on fullscreen to avoid	issues
	      related to resolution switching. Otherwise fullscreen will use a
	      resolution that is closest to the	Hatari window size.   (enabled
	      by default)

       --force-max <bool>
	      Hatari window size is forced to specified	maximum	size and black
	      borders  used  when Atari	resolution doesn't scale evenly	to it.
	      This is most useful when recording videos	of Falcon  demos  that
	      change their resolution. (disabled by default)

       --aspect	<bool>
	      Whether  to  do  monitor aspect ratio correction (enabled	by de-
	      fault)

VDI options
       --vdi <bool>
	      Whether to use VDI screen	mode.  Doesn't work with TOS  v4.  TOS
	      v3 memory	detection isn't	compatible with	larger VDI modes (i.e.
	      you  need	 to skip the detection at boot). Original TOS desktops
	      use wrong	window size in 2-plane (4 color) VDI mode when	screen
	      height  >= 400 pixels.  Because of these issues, using EmuTOS is
	      recommended for VDI mode

       --vdi-planes <x>
	      Use extended VDI resolution with bit depth <x> (x	= 1, 2 or 4)

       --vdi-width <w>
	      Use extended VDI resolution with width <w> (320 <	w <= 2048)

       --vdi-height <h>
	      Use extended VDI resolution with height <h> (160 < h <= 1280)

       Because TOS and popular GEM programs have problems with certain	screen
       sizes,  Hatari  enforces	restrictions on	VDI screen size.  In total VDI
       screen size is limited to 32-300kB, width to multiple of	16/planes, and
       height to multiple of 8	pixels	(smaller  system  font	height).  That
       translates to following maximum standard	resolutions for	the VDI	mode:

       monochrome
	      FullHD (1920x1080), WUXGA	(1920x1200) and	QWXGA (2048x1152)

       2 plane mode (4 colors)
	      HD (1280x720), WXGA (1280x768) and XGA+ (1152x864)

       4 plane mode (16-colors)
	      qHD (960x540), DVGA (960x640) and	WSVGA (1024x600)

Screen capture options
       --crop <bool>
	      Remove statusbar from the	screen captures

       --avirecord
	      Start  AVI  recording.   Note: recording will automatically stop
	      when emulation resolution	changes.

       --avi-vcodec <x>
	      Select AVI video codec (x	= bmp/png).  PNG  compression  can  be
	      much  slower  than using the uncompressed	BMP format, but	uncom-
	      pressed video content takes huge amount of space.

       --png-level <x>
	      Select PNG compression level for AVI video (x = 0-9).  Both com-
	      pression efficiency and speed depend on  the  compressed	screen
	      content.	Highest	 compression level (9) can be really slow with
	      some content. Levels 3-6 should compress	nearly	as  well  with
	      clearly smaller CPU overhead.

       --avi-fps <x>
	      Force AVI	frame rate (x =	50/60/71/...)

       --avi-file <file>
	      Use <file> to record AVI

       --screenshot-dir	<dir>
	      Save screenshots in the directory	<dir>

Devices	options
       -j, --joystick <port>
	      Emulate joystick with cursor keys	in given port (0-5)

       --joy<port> <type>
	      Set joystick type	(none/keys/real) for given port

       --printer <file>
	      Enable printer support and write data to <file>

       --midi <bool>
	      Whether to enable	MIDI device support (when Hatari is built with
	      PortMidi support)

       --midi-in <filename>
	      Enable  MIDI support and write raw MIDI data to <file> (when not
	      built with PortMidi support)

       --midi-out <filename>
	      Enable MIDI support and read raw MIDI data from <file> (when not
	      built with PortMidi support)

       --rs232-in <filename>
	      Enable MFP serial	port support and use <file> as the  input  de-
	      vice

       --rs232-out <filename>
	      Enable  MFP serial port support and use <file> as	the output de-
	      vice

       --scc-a-in <filename>
	      Enable SCC channel A serial port support and use <file> for  the
	      input (only for Mega-STE,	TT and Falcon)

       --scc-a-out <filename>
	      Enable  SCC channel A serial port	support	and use	<file> for the
	      output (only for Mega-STE, TT and	Falcon)

       --scc-a-lan-in <filename>
	      Enable SCC channel A LAN port support and	use <file> for the in-
	      put (only	for Mega-STE and TT)

       --scc-a-lan-out <filename>
	      Enable SCC channel A LAN port support and	 use  <file>  for  the
	      output (only for Mega-STE	and TT)

       --scc-b-in <filename>
	      Enable  SCC channel B serial port	support	and use	<file> for the
	      input (only for Mega-STE,	TT and Falcon)

       --scc-b-out <filename>
	      Enable SCC channel B serial port support and use <file> for  the
	      output (only for Mega-STE, TT and	Falcon)

Floppy drive options
       --drive-a <bool>
	      Enable/disable drive A (default is on)

       --drive-b <bool>
	      Enable/disable drive B (default is on)

       --drive-a-heads <x>
	      Set number of heads for drive A (1=single	sided, 2=double	sided)

       --drive-b-heads <x>
	      Set number of heads for drive B (1=single	sided, 2=double	sided)

       --disk-a	<file>
	      Set disk image for floppy	drive A

       --disk-b	<file>
	      Set disk image for floppy	drive B

       --fastfdc <bool>
	      speed up FDC emulation (can cause	incompatibilities)

       --protect-floppy	<x>
	      Write  protect  floppy image contents (on/off/auto). With	"auto"
	      option write protection is according to the disk image file  at-
	      tributes

Hard drive options
       -d, --harddrive <dir>
	      GEMDOS  HD emulation.  Emulate harddrive partition(s) with <dir>
	      contents.	 If directory contains only single letter (C-Z)	subdi-
	      rectories, each of these subdirectories will  be	treated	 as  a
	      separate partition, otherwise the	given directory	itself will be
	      assigned to drive	"C:". In the multiple partition	case, the let-
	      ters used	as the subdirectory names will determine to which dri-
	      ves/partitions  they  are	assigned. If <dir> is an empty string,
	      then harddrive's emulation is disabled

       --protect-hd <x>
	      Write  protect  harddrive	 <dir>	contents  (on/off/auto).  With
	      "auto"  option the protection can	be controlled by setting indi-
	      vidual files attributes as it disables the file attribute	 modi-
	      fications	for the	GEMDOS hard disk emulation

       --gemdos-case <x>
	      Specify  whether	new dir/filenames are forced to	be in upper or
	      lower case with the GEMDOS HD emulation. Off/upper/lower,	off by
	      default

       --gemdos-time <x>
	      Specify what file	modification timestamps	should be used,	emula-
	      tion internal (atari) ones, or ones from the machine  (host)  on
	      which  the  machine  is  running.	While Atari emulation and host
	      clocks are in sync at Hatari startup, they  will	diverge	 while
	      emulation	 is  running, especially if you	use fast forward.  De-
	      fault is "atari".	 If you	modify files  accessed	by  the	 Atari
	      side,  directly  from the	host side while	Hatari is already run-
	      ning, you	may want to use	"host" option

       --gemdos-conv <bool>
	      Whether GEMDOS file names	with 8-bit (non-ASCII) characters  are
	      converted	 between Atari and host	character sets.	On Linux, host
	      file name	character set is assumed to be UTF-8. This  option  is
	      disabled	by  default,  in  case you have	transferred files from
	      Atari machine without proper file	name conversion	(e.g. by  zip-
	      ping them	on Atari and unzipping on PC)

       --gemdos-drive <drive>
	      Assign  (separately  specified)  GEMDOS HD to given drive	letter
	      (C-Z) instead of default C:,  or	use  "skip"  to	 specify  that
	      Hatari  should  add GEMDOS HD after IDE and ACSI drives (assumes
	      Hatari and native	HD driver parse	same number of partitions from
	      the partition tables in HD images)

       --acsi <id>=<file>
	      Emulate an ACSI hard disk	with given BUS ID  (0-7)  using	 image
	      <file>.  If just a filename is given, it is assigned to BUS ID 0

       --scsi <id>=<file>
	      Emulate  a  SCSI	hard  disk with	given BUS ID (0-7) using image
	      <file>.  If just a filename is given, it is assigned to BUS ID 0

       --ide-master <file>
	      Emulate an IDE 0 (master)	hard disk with an image	<file>

       --ide-slave <file>
	      Emulate an IDE 1 (slave) hard disk with an image <file>

       --ide-swap <id>=<x>
	      Set byte-swap option <x> (off/on/auto) for given IDE <id>	(0/1).
	      If just option is	given, it is applied to	IDE 0

Memory options
       --memstate <file>
	      Load memory snap-shot <file>

       -s, --memsize <x>
	      Set amount of emulated ST	RAM, x = 1 to 14 MiB,  or  0  for  512
	      KiB.   Other  values  are	 considered  as	 a size	in KiB.	 While
	      Hatari allows 14 MiB for all machine types, on real  HW,	ST/STE
	      can  have	up to 4	MiB, MegaSTE/TT	up to 10 MiB, and Falcon up to
	      14 MiB RAM.

       -s, --ttram <x>
	      Set amount of emulated TT	RAM, x = 0 to 1024 MiB (in 4MiB	steps)

ROM options
       -t, --tos <imagefile>
	      Specify TOS ROM image to use

       --patch-tos <bool>
	      Use this option to  enable/disable  TOS  ROM  patching.  Experts
	      only! Leave this enabled unless you know what you	are doing!

       --cartridge <imagefile>
	      Use  ROM	cartridge image	<file> (only works if GEMDOS HD	emula-
	      tion and extended	VDI resolution are disabled)

CPU/FPU/bus options
       --cpulevel <x>
	      Specify CPU (680x0) to use (use x	>= 1 with  EmuTOS  or  TOS  >=
	      2.06 only!)

       --cpuclock <x>
	      Set the CPU clock	(8, 16 or 32 Mhz)

       --compatible <bool>
	      Use  a more compatible 68000 CPU mode with better	prefetch accu-
	      racy and cycle counting

       --cpu-exact <bool>
	      Use cycle	exact CPU emulation (cache emulation)

       --addr24	<bool>
	      Use 24-bit instead of 32-bit addressing mode (24-bit is  enabled
	      by default)

       --fpu <x>
	      FPU type (x=none/68881/68882/internal)

       --fpu-softfloat <bool>
	      Use full software	FPU emulation (Softfloat library)

       --mmu <bool>
	      Use MMU emulation

Misc system options
       --machine <x>
	      Select machine type (x = st, megast, ste,	megaste, tt or falcon)

       --blitter <bool>
	      Enable blitter emulation (ST only)

       --dsp <x>
	      Falcon DSP emulation (x =	none, dummy or emu, Falcon only)

       --vme <x>
	      Hatari  doesn't  have  proper  MegaSTE/TT	VME emulation yet, but
	      this controls access to related SCU registers (MegaSTE/TT	only).

	      With "dummy", (no-op) access is allowed (=VME HW), otherwise TOS
	      v2 and v3	crash on bootup	on MegaSTE and TT.  Supports VME trac-
	      ing.

	      With "none", register access causes errors (=no VME  HW),	 which
	      is needed	for Linux to boot with TT emulation until there's full
	      SCU interrupt support.  No VME tracing support.

       --rtc-year <x>
	      With  the	 default value 0, RTC date and time are	taken from the
	      host.  If	application does not handle current dates, this	can be
	      used to change RTC year to a  more  compatible  one.   See  also
	      "--gemdos-time" option.

       --timer-d <bool>
	      Patch  redundantly  high Timer-D frequency set by	TOS.  This can
	      increase Hatari speed significantly (especially for ST/e	emula-
	      tion)  as	 the original Timer-D frequency	causes large amount of
	      extra interrupts to emulate.

       --fast-boot <bool>
	      Patch TOS	and initialize the so-called "memvalid"	 system	 vari-
	      ables  to	 by-pass  the  memory  test of TOS, so that the	system
	      boots faster.

Sound options
       --mic <bool>
	      Enable/disable (Falcon only) microphone

       --sound <x>
	      Sound frequency: 6000-50066. "off" disables the sound and	speeds
	      up the emulation.	To prevent extra  sound	 artifacts,  the  fre-
	      quency  should be	selected so that it either matches evenly with
	      the STE/TT/Falcon	sound DMA (6258, 12517,	250033,	50066  Hz)  or
	      your sound card frequencies (11025, 22050, 44100 or 6000...48000
	      Hz).  Check what your sound card supports.

       --sound-buffer-size <x>
	      SDL's  sound  buffer  size:  10-100,  or 0 to use	default	buffer
	      size.  By	default	Hatari uses an SDL buffer size	of  1024  sam-
	      ples,  which  gives approximately	20-30 ms of sound depending on
	      the chosen sound frequency. Under	some OS	or with	not fully sup-
	      ported sound card, this default setting can cause	a bigger delay
	      at lower frequency (nearly 0.5 sec).  In that case, you can  use
	      this  option  to	force  the size	of the sound buffer to a fixed
	      number of	milliseconds of	sound (using 20	is often a good	choice
	      if you have such problems). Most users will not  need  this  op-
	      tion.

       --sound-sync <bool>
	      The  emulation rate is nudged by +100 or 0 or -100 micro-seconds
	      on occasion.  This prevents the sound  buffer  from  overflowing
	      (long  latency  and lost samples)	or underflowing	(short latency
	      and repeated samples).  The emulation rate smoothly deviates  by
	      a	 maximum  of 0.58% until synchronized, while the emulator con-
	      tinuously	generates every	sound  sample  and  the	 crystal  con-
	      trolled sound system consumes every sample.
	      (on|off, off=default)

       --ym-mixing <x>
	      Select  a	 method	 for mixing the	three YM2149 voice volumes to-
	      gether.  "model" uses a mathematical model  of  the  YM  voices,
	      "table"  uses a lookup table of audio output voltage values mea-
	      sured on STF and "linear"	just averages the 3 YM voices.

Debug options
       -W, --wincon
	      Open console window (Windows only)

       -D, --debug
	      Toggle whether CPU exceptions invoke the debugger

       --debug-except <flags>
	      Specify which exceptions	invoke	debugger,  see	--debug-except
	      help for available (comma	separated) exception flags.

       --lilo <string>
	      Boot  m68k  Linux	 using	kernel,	 ramdisk, and kernel arguments
	      specified	in  the	 Hatari	 configuration	file  [LILO]  section.
	      Hatari  documentation folder contains an example "lilo.cfg" con-
	      fig file for this. String	given to the --lilo option is appended
	      to the kernel command line.
	      NOTE: This is Hatari (and	Linux kernel) developer	option to test
	      Linux booting.  Unless you know how your kernel  is  configured,
	      and  the state of	specific kernel	and Hatari features, don't ex-
	      pect m68k	Linux to boot up successfully.

       --bios-intercept	<bool>
	      Enable/Disable XBios command parsing. XBios(11) Dbmsg  call  can
	      be  used	to invoke Hatari debugger. XBios(20) printscreen calls
	      produce also Hatari screenshots. XBios(255)  allows  Atari  pro-
	      grams  to	 use  Hatari debugger functionality, which allows e.g.
	      invoking shortcuts and Hatari command line options. Last one  is
	      deprecated  as  it  gives	 too much control to emulated program,
	      please use NatFeats and remote control APIs (--natfeats,	--cmd-
	      fifo, hconsole) instead of XBios 11 and 255.

       --conout	<device>
	      Enable console (xconout vector functions)	output redirection for
	      given  <device>  to  host	 terminal.  Device 2 is	for the	(CON:)
	      VT52 console, which vector function catches  also	 EmuTOS	 panic
	      messages	and  MiNT console output, not just normal BIOS console
	      output.

       --disasm	<x>
	      Set disassembly options.	'uae' and 'ext'	select the disassembly
	      engine to	use,  bitmask  sets  disassembly  output  options  and
	      'help' lists them.

       --natfeats <bool>
	      Enable/disable  (basic)  Native Features support.	EmuTOS uses it
	      for debug	output,	and it's supported also	by the	Aranym	emula-
	      tor.   For  more	info,  see  example  code  and	readme.txt  in
	      tests/natfeats/ coming with Hatari sources.

       --trace <flags>
	      Activate debug traces, see --trace  help	for  available	(comma
	      separated) tracing flags

       --trace-file <file>
	      Save trace output	to <file> (default=stderr)

       --msg-repeat
	      Toggle whether successive	repeats	of identical log or trace mes-
	      sages will be suppressed,	so that	only their count is shown (de-
	      fault=suppress).	 Disassembly,  register	 and  (multi-line) AES
	      traces bypass this feature

       --parse <file>
	      Parse/execute debugger commands from <file>

       --saveconfig
	      Save Hatari configuration	and exit. Hatari UI needs Hatari  con-
	      figuration file to start,	this can be used to create it automat-
	      ically.

       --control-socket	<path>
	      Hatari  connects	to  given local	socket file and	reads commands
	      from it.	Use when the control process life-time is longer  than
	      Hatari's,	or control process needs response from Hatari

       --cmd-fifo <path>
	      Hatari  creates  the indicated FIFO file and reads commands from
	      it.  Commands can	be echoed to FIFO file,	and are	same  as  with
	      the  control  socket.  Hatari outputs help for unrecognized com-
	      mands and	subcommands

       --log-file <file>
	      Save log output to <file>	(default=stderr)

       --log-level <x>
	      Log output level (x=debug/todo/info/warn/error/fatal)

       --alert-level <x>
	      Show dialog for log messages above given level

       --run-vbls <x>
	      Exit after X VBLs.  Often	used with --benchmark option

       --benchmark
	      Start in benchmark mode.	Currently same as --fast-forward mode,
	      except it	can't be disabled at run-time. Allows better measuring
	      for the speed of the emulation in	 frames	 per  second.	Unless
	      you're specifically measuring emulator audio and screen process-
	      ing speed, disable them (--sound off/--disable-video on) to have
	      as little	OS overhead as possible

INPUT HANDLING
       Hatari provides special input handling for different purposes.

Emulated Atari ST joystick
       Joystick	can be emulated	either with keyboard or	any real joystick sup-
       ported  by  your	 kernel	 / SDL library.	 First joystick	button acts as
       FIRE, second as SPACE key.

Emulated Atari ST mouse
       Middle button mouse click is interpreted	as double click, this is espe-
       cially useful in	Fast Forward mode.

       Mouse scrollwheel will act as cursor up and down	keys.

Emulated Atari ST keyboard
       Keys on the keyboard act	as the normal Atari ST keys so pressing	 SPACE
       on your PC will result in an emulated press of the SPACE	key on the ST.
       How the PC keys are mapped to Atari key codes, can be changed with key-
       board config file (-k option).

       The following keys have special meanings:

       Alt    will act as the ST's ALTERNATE key

       left Ctrl
	      will act as the ST's CONTROL key

       Print  will emulate the ST's HELP key

       Scroll lock
	      will emulate the ST's UNDO key

       AltGr  will act as Alternate as well as long as you do not press	it to-
       gether with a Hatari hotkey combination.

       The right Ctrl key is used as the fire button of	the emulated  joystick
       when you	turn on	joystick emulation via keyboard.

       The  cursor keys	will act as the	cursor keys on the Atari ST as long as
       joystick	emulation via keyboard has been	turned off.

Keyboard shortcuts during emulation
       The shortcut keys can be	configured in the configuration	file.  The de-
       fault settings are:

       AltGr + a
	      record animation

       AltGr + g
	      grab a screenshot

       AltGr + i
	      boss key:	leave full screen mode and iconify window

       AltGr + m
	      (un-)lock	the mouse into the window

       AltGr + r
	      warm reset the ST	(same as the reset button)

       AltGr + c
	      cold reset the ST	(same as the power switch)

       AltGr + d
	      open dialog to select/change disk	A

       AltGr + s
	      enable/disable sound

       AltGr + q
	      quit the emulator

       AltGr + x
	      toggle normal/max	speed

       AltGr + y
	      enable/disable sound recording

       AltGr + k
	      save memory snapshot

       AltGr + l
	      load memory snapshot

       AltGr + j
	      toggle joystick emulation	via cursor keys

       AltGr + F1
	      switch joystick type on joy port 0

       AltGr + F2
	      switch joystick type on joy port 1

       AltGr + F3
	      switch joystick type for joypad A

       AltGr + F4
	      switch joystick type for joypad B

       AltGr + b
	      toggle borders on/off

       AltGr + f or F11
	      toggle between fullscreen	and windowed mode

       AltGr + o or F12
	      activate the Hatari options GUI
	      You may need to hold SHIFT down while in windowed	mode.

       Pause  Pauses the emulation

       AltGr + Pause
	      Invokes the internal Hatari debugger

Keyboard shortcuts for the SDL GUI
       There are multiple ways to interact with	the SDL	GUI.

       TAB and cursor keys change the focus  between  UI  elements.  Home  key
       moves  focus  to	 the first dialog item,	End key	to the last one.  Ini-
       tially focus is on the default UI element, but focus changes are	remem-
       bered between dialog invocations.

       Enter and Space invoke the focused item,	ESC  key  invokes  the	dialog
       cancel option (if there is one).

       UI  element  which  name	has an underlined character can	be invoked di-
       rectly by pressing Alt +	key with that character.   Alt	+  arrow  keys
       will act	on dialog arrow	buttons.

       Main interactions:

       Options GUI main	view
	      Enter accepts configuration, ESC cancels it.

       Options GUI dialogs
	      Enter  (or End + Enter if	focus was moved), returns back to main
	      view.

       Fileselector
	      Page up and down keys move the file  list	 by  one  page,	 mouse
	      wheel  and Alt + cursor keys scroll it by	one item. Enter	on the
	      focused file name	selects	it. Enter on the OK button accepts the
	      selected file. ESC cancels the dialog/selection.

       Alert dialogs
	      Enter accepts and	ESC cancels the	dialog.

SEE ALSO
       The  main  program  documentation,  usually  in	/usr/local/share/doc/.
       Among other things it contains an extensive usage manual, software com-
       patibility list and release notes.

       The homepage of Hatari: http://hatari.tuxfamily.org/

       Other Hatari programs and utilities:
       hmsa(1),	 zip2st(1),  atari-convert-dir(1),  atari-hd-image(1),	hatar-
       iui(1), hconsole(1), gst2ascii(1), hatari_profile(1)

FILES AND DIRECTORIES
       /usr/local/etc/hatari.cfg
	      The global configuration file of Hatari.

       ~/.config/hatari/
	      The  (default)  directory	 for  user's  personal	Hatari	files;
	      hatari.cfg  (configuration  file),  hatari.nvram	(NVRAM content
	      file), hatari.sav	 (Hatari  memory  state	 snapshot  file	 which
	      Hatari   can  load/save  automatically  when  it	starts/exits),
	      hatari.prn (printer output file),

       /usr/local/share/hatari/	(or /usr/local/share/hatari/)
	      The global data directory	of Hatari.

       tos.img
	      The TOS ROM image	will be	loaded	from  the  data	 directory  of
	      Hatari unless it is specified on the command line	or the config-
	      uration file.

AUTHOR
       This  manual  page was written by Marco Herrn <marco@mherrn.de> for the
       Debian project and later	modified by Thomas Huth	and Eero  Tamminen  to
       suit the	latest version of Hatari.

Hatari				  2020-11-27			     HATARI(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=hatari&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help