Configuration file

The zest.cfg file contains default configuration values. The format is a INI-style key-value text file. It is divided in different sections, such as [main] and [floppy].

The different possible settings are listed below. For file path names, the SD card mount point is /sdcard, so if you need to address for instance a file named foo.msa from a floppy directory which resides in the root directory of the SD card, the full path name would be /sdcard/floppy/foo.msa.

[main] section

  • mono: boolean setting (true/false). If true, zeST starts in monochrome high resolution mode.
  • blitter: boolean setting (true/false). If true, the blitter is enabled
  • extended_video_modes: boolean setting (true/false). If true, extra resolution modes become available to software running on zeST. See the dedicated section for more details.
  • turbo: boolean setting (true/false). If true, turbo mode is enabled
  • mem_size: memory size. Possible values are: 256K, 512K, 1M, 2M, 2.5M, 4M, 8M, 14M.
  • wakestate: GLUE wakestate setting. Possible values are 1, 2, 3, 4.
  • shifter_wakestate: Shifter wakestate setting. Possible values are 0 and 1.
  • scan_doubler_mode: Scan doubling mode. Possible values are 0 (for double lines) and 1 (for a CRT screen-like effect).
  • rom_file: full pathname to the default ROM image file.
  • timezone: Local timezone relative to UTC. Possible values are integers from -12 to 12.

[floppy] section

  • floppy_a: full pathname for the floppy image file in drive A. If you don't want to have a floppy inserted at boot, just leave this field empty. You can also set it to a directory name with the / suffix to set a default image search directory.
  • floppy_a_enable: this is a true/false toggle to determine if floppy drive A is available. It is enabled by default.
  • floppy_a_write_protect: this is a true/false toggle to determine if inserted floppy disk in drive A is write protected or not.
  • floppy_b: same as floppy_a, but for drive B.
  • floppy_b_enable: same as floppy_a, but for drive B. It is disabled by default.
  • floppy_b_write_protect: same as floppy_a, but for drive B.

[hdd] section

  • acsiN: full pathname for a ACSI hard disk image file. You can mount an Atari-formatted SD card (for instance coming from an Ultrasatan drive) by plugging a USB SD card reader and using the device file name (typically, something like /dev/sda) as the image file. Replace N with the ACSI ID (between 0 and 7) you are using. Multiple images can be set to different ACSI IDs.
  • gemdos: full pathname to the directory to be mapped as the GEMDOS drive.

[keyboard] section

  • keymap_id: keymap id. Possible values are: dk,nl,uk,us,fr,bepo,de,no,pl,es,se.
  • right_alt_is_altgr: boolean setting (true/false). If true, the keyboard's right Alt key is treated differently from left Alt. See the PC keyboard support section below for more details. If false, both Alt keys are mapped to the ST Alternate key.

[midi] section

  • midi_in: The MIDI identifier of the device to be used as input.
  • midi_out: The MIDI identifier of the device to be used as output.

[jukebox] section

  • enabled: boolean setting (true/false). If true, jukebox mode is enabled and a new image file is chosen at each new period.
  • mode: the jukebox play mode mode. Possible values are
    • 0: next file is chosen at random;
    • 1: next chosen image file is the following in alphabetical order.
  • path: The path name of the floppy image files directory for jukebox mode.
  • timeout: Integer value. This is the jukebox period in seconds.