Skip to content

GUI Global Settings

Dimitris Panokostas edited this page Jul 5, 2026 · 1 revision

Global Settings Panel

The Global Settings panel edits Amiberry-wide defaults that are stored in amiberry.conf, plus a small number of INI-backed UI/input settings stored in amiberry.ini.

These settings are loaded during startup before a normal .uae configuration is applied. A game or machine configuration can still override many of them.

Use Save Global Settings to write the current values back to disk.

Groups

The panel is organized into collapsible groups.

Startup and GUI

  • Quickstart on startup
  • Config description reading
  • GUI joystick navigation
  • Shutdown button visibility
  • Default Quickstart compatibility level

Input defaults and hotkeys

  • Right Ctrl as Right Amiga
  • Mouse speed
  • Keyboard-as-joystick keypress handling
  • Joystick deadzone
  • Default GUI, quit, Action Replay, and fullscreen hotkeys
  • RetroArch quit, menu, and reset button mappings
  • Default controller and mouse assignments

Display defaults

  • Line mode
  • Horizontal and vertical centering
  • Scaling method
  • Auto-resolution
  • Frameskip
  • Correct aspect ratio
  • Auto crop
  • Default width and height
  • Fullscreen mode

Sound defaults

  • Stereo separation
  • Sound frequency
  • Sound buffer size
  • Sound device index

WHDLoad defaults

  • Button wait
  • Splash screen
  • Config delay
  • Write cache
  • Quit on exit
  • JST preference
  • Allow display settings from XML

Touch and on-screen controls

  • On-screen joystick
  • On-screen keyboard
  • On-screen keyboard transparency
  • On-screen keyboard layout: US, UK, DE, or FR
  • On-screen keyboard toggle
  • RetroArch virtual keyboard button mapping

The current on-screen keyboard does not use the legacy high-resolution artwork, style/theme, or virtual-keyboard quit-button defaults.

Visual defaults

  • GUI theme
  • Native and RTG shader presets
  • Bezel defaults

Paths and logging

  • Logfile output
  • Base content folder
  • Managed content, configuration, visual asset, plugin, screenshot, save-state, and video folders

Updates

  • Startup update checks
  • Update channel
  • Skipped version

Advanced / compatibility

  • Performance logging
  • Slow-host warning
  • Android ADPF tuning
  • Disable cycle-exact defaults

INI-backed UI/input behavior

  • Swap Backslash and F11
  • Swap End and Page Up

Notes

  • Path and global default changes are written to amiberry.conf.
  • The INI-backed keyboard swap options are written to amiberry.ini.
  • Some defaults only affect newly loaded configurations or the next emulator start.

Clone this wiki locally