config.example.yaml

# Copy this file to config.yaml and uncomment only the settings you use.

# CPU micro-architecture (Extension p rollout). The emulator boots on the
# pipelined CPU by default; set scalar to use the reference single-step CPU.
# The --cpu CLI flag overrides this key.
#cpu:
#  microarchitecture: "pipeline" # "pipeline" (default), "cached" or "scalar"
#  jit_block_size: 16 # JIT only: Small=16 (default), Medium=32, Big=64; custom 2..256

# Log verbosity: trace, debug, info, warn, error, or off (default: info).
# logging:
#   level: debug

# BIOS ROM image (POST + IPL, runs from 0xFF000000, 64 KiB max).
# Build it with: python bios/build.py -> assets/bios.rom (C BIOS, doc/spec_BIOS.md).
# Relative paths are resolved from the directory containing config.yaml.
# Omit this section to boot the guest program straight from RAM at 0x0.
#bios:
#  image: "assets/bios.rom"

# Main RAM and VDP VRAM capacities. Omit either key to use its default.
# RAM supports 1..256 MiB. VRAM supports 4..128 MiB (4 MiB default).
#memory:
#  ram_mib: 16
#  vram_mib: 4

pcg:
  # Raw PCG font bank image: exactly 2 KiB (one bank) or 4 KiB (both banks).
  # Relative paths are resolved from the directory containing config.yaml.
  # font: "assets/UNSCII.F08"
  # Mode 3 font: exactly 4 KiB (256 glyphs x 16 rows, bit 7 = left pixel).
  # Loads dedicated VRAM 0x21000..0x21FFF; does not select the screen mode.
  # font_8x16: "path/to/font.f16"

# Connect up to four raw disk images. Relative paths are resolved from the
# directory containing config.yaml. Each configured image must already exist.
# disk:
#   - slot: 0
#     type: "hdd" # "fdd" or "hdd"
#     image: "disk0.img"
#     read_only: true
#     transfer_rate_bytes_per_second: 48000000
#     access_latency_ms: 0
#     # Operation sound profile (internal_name from the asset pack below).
#     # Omit to keep the slot silent.
#     sound_profile: "Seagate_ST3120A_3211RPM"

# Disk operation sounds (spindle hum + seek clicks). Sound samples are NOT
# bundled: because of their licenses, check out
# https://github.com/86Box/assets yourself and point asset_root at the
# directory containing its sounds/ folder (it also provides
# sounds/hdd/hdd_audio_profiles.cfg and sounds/fdd/fdd_audio_profiles.cfg).
# Without an asset pack (or without sound_profile assignments) the emulator
# stays silent; a broken sound setup only warns and never fails to boot.
# disk_sound:
#   asset_root: "assets-86box"
#   volume: 1.0 # global gain, 0.0 (muted) .. 4.0
#   default_fdd_profile: "panasonic_ju4755_40t"
#   default_hdd_profile: "Seagate_ST3120A_3211RPM"

# WASM expansion cards use ZIP packages with a root manifest.yaml.
# Assets are decompressed only when the guest first reads them.
# expansion_card:
#   - slot: 0
#     package: "plugins/timer.cpt32card"