v2026.04.02/emulators/holani.yml

emulator: Holani
type: libretro
core_classification: official_port
source: "https://github.com/LLeny/holani-retro"
upstream: "https://github.com/LLeny/holani"
profiled_date: "2026-03-24"
core_version: "0.9.9"
display_name: "Atari - Lynx (Holani)"
cores: [holani]
systems: [atari-lynx]
verification: existence

notes: |
  Holani is a cycle-stepped Atari Lynx emulator written in Rust by LLeny.
  The libretro port (holani-retro) loads lynxboot.img from the system
  directory at retro_load_game time (lib.rs:110-124). Path is built as
  system_directory + "/lynxboot.img", no subdirectory.

  The core library (holani/src/rom.rs) embeds a free boot ROM from
  https://bjoern.spruck.net/lynx/ as FREE_BOOTROM (512 bytes), used as
  the default when no external ROM is loaded (Rom::default()). The
  libretro wrapper attempts to load the real lynxboot.img, but if the
  file is missing or the system directory is invalid, Lynx::new() already
  has the free boot ROM initialized. No hash validation on the external
  file; Rom::from_slice() only checks length == 512.

files:
  - name: "lynxboot.img"
    system: atari-lynx
    description: "Atari Lynx boot ROM"
    required: false
    hle_fallback: true
    size: 512
    validation: [size]
    source_ref: "src/lib.rs:110-124 (bios load), holani/src/rom.rs:72-79 (size validation)"