Amiberry uses a global configuration file named amiberry.conf, located in the platform settings directory. This file controls defaults and preferences that apply before a specific game configuration is loaded.

Default bootstrap locations:

• Linux: ~/.config/amiberry/amiberry.conf
• macOS: ~/Library/Application Support/Amiberry/amiberry.conf
• Windows: %LOCALAPPDATA%\\Amiberry\\amiberry.conf
• Android: the app-private settings directory returned by SDL_GetPrefPath("BlitterStudio", "Amiberry")
• Portable mode: <portable-root>/Settings/amiberry.conf

• Keys are case-sensitive (for example, Quickstart is not the same as quickstart).
• Most values are yes/no, integers, or strings.
• Some entries (like recent files lists) are managed automatically and do not need manual editing.

Controls if the GUI starts on the Quickstart panel.

• Values: yes, no

If enabled, Amiberry reads the Description field inside each config file to show it in the list (slower for large libraries).

• Values: yes, no

Enables logging to the logfile (amiberry_log.txt).

• Values: yes, no

Enable/disable controller navigation in the GUI.

• Values: yes, no

Disables the Shutdown button in the GUI.

• Values: yes, no

Sets the visual theme for the GUI.

• Example: gui_theme=Default.theme

Default window/screen size.

• Values:
  • -1: Auto
  • 0: Nearest Neighbor
  • 1: Linear
  • 2: Integer Scaling

• Values: 0 (Single), 1 (Double), 2 (Scanlines)

Enable auto resolution switching by default.

• Values: yes, no

Enable frameskip by default.

• Values: yes, no

Correct aspect ratio by default.

• Values: yes, no

Auto-crop by default.

• Values: yes, no

Default screen mode for the emulator window. The value maps directly to the underlying SDL window mode used when the emulator window is created.

• Values:
  • 0 — Windowed. Regular resizable window on the desktop. No SDL fullscreen flag is set.
  • 1 — Fullscreen (exclusive). SDL sets the window to SDL_WINDOW_FULLSCREEN with a specific SDL_DisplayMode chosen via SDL_GetClosestFullscreenDisplayMode(), so the monitor actually switches to match the emulator output resolution.
  • 2 — Full-window (borderless desktop fullscreen). SDL sets the window to SDL_WINDOW_FULLSCREEN with no specific display mode (SDL_SetWindowFullscreenMode(window, nullptr)), so the window fills the entire desktop at the current monitor resolution without a mode change. Recommended for modern displays and for integer scaling.

Enable centering by default.

• Values: yes, no

Allow display settings from WHDLoad XML to override these defaults.

• Values: yes, no

Sample rate in Hz.

Audio buffer size setting for the emulator-side sound buffer. Smaller values usually reduce latency but may be less robust on slower systems.

Stereo separation level.

Default sound card index (0 = system default).

Map Right Ctrl to Right Amiga (useful for keyboards without RAmiga).

• Values: yes, no

Default mouse speed.

When using keyboard as joystick, suppress double keypresses.

• Values: yes, no

Default devices for auto-booting.

• Example: default_controller1=joy0
• Example: default_mouse1=mouse

Key to open the GUI.

Key to instantly quit Amiberry.

Key to open Action Replay.

Key to toggle fullscreen.

Deadzone percentage (0-100).

Enable RetroArch Quit HotKey.

• Values: yes, no

Enable RetroArch Menu HotKey.

• Values: yes, no

Enable RetroArch Reset HotKey.

• Values: yes, no

Enable RetroArch VKBD HotKey.

• Values: yes, no

Enable WHDLoad ButtonWait by default.

• Values: yes, no

Show WHDLoad splash screen by default.

• Values: yes, no

Delay (in seconds) before WHDLoad auto-config is applied.

Enable WHDLoad WriteCache.

• Values: yes, no

Quit emulator when WHDLoad title exits.

• Values: yes, no

Prefer JST titles if both are available.

• Values: yes, no

Enable on-screen keyboard by default.

• Values: yes, no

Use the high-resolution virtual keyboard.

• Values: yes, no

Enable quit button on the virtual keyboard.

• Values: yes, no

Virtual keyboard language/layout.

Virtual keyboard style/theme.

Transparency level (0-100).

Controller button used to toggle the virtual keyboard.

See the Shaders wiki page for full documentation.

Shader to use for native (Amiga chipset) modes. Can be a built-in name (none, tv, pc, lite, 1084), a single-pass shader filename (crt-pi.glsl), or a multi-pass preset path (crt/crt-aperture.glslp).

Shader to use for RTG (Picasso96) modes. Accepts the same values as shader.

Force mobile-optimized shaders.

• Values: yes, no

Enable a custom bezel overlay image.

• Values: yes, no

Filename of the bezel image (relative to the bezels directory). Set to none to disable.

• Example: custom_bezel=commodore_1084.png

These paths are auto-managed and set by the Paths panel and Rescan Paths:

• base_content_path
• config_path
• controllers_path
• retroarch_config
• whdboot_path
• whdload_arch_path
• floppy_path
• harddrive_path
• cdrom_path
• logfile_path
• rom_path
• rp9_path
• floppy_sounds_dir
• saveimage_dir
• savestate_dir
• screenshot_dir
• ripper_path
• inputrecordings_dir
• nvram_dir
• plugins_dir
• video_dir
• themes_path
• shaders_path
• bezels_path

Optional bulk root for Amiberry's managed content/config directories. When this is set, Amiberry derives the standard folders from that root first, including the separate Visuals / visuals subtree for Themes, Shaders, and Bezels, then any explicit path entries listed below can override individual locations. Amiberry writes only the explicit per-path overrides that differ from the derived locations, so changing base_content_path remains authoritative.

These entries are maintained by Amiberry and normally should not be edited:

• MRUDiskList / Diskfile
• MRUCDList / CDfile
• MRUWHDLoadList / WHDLoadfile

Read-only when used via the command line (-o amiberry_config=path), allowing you to point to a different amiberry.conf file.

The following option appears in older documentation but is not used in current builds:

• rotation_angle