5DO 1.9.0¶
Released: 2026-11-14
5DO 1.9.0 is a feature and interoperability release. It adds English/German localization, external metadata lookup with manual media attachments, physical optical drive boot, a Windows DirectInput/HID gamepad backend, a live controller preview, automatic blank-border crop, display-sleep inhibition, Lua input scripting with an editable input timeline, and best-effort 4DO .4dosav import/export.
The deterministic emulation core, frame/audio/state hashes, and the documented binary compatibility model are unchanged.
Localization¶
- Embedded English and German catalogs in
FiveDo.Localization; the JSON is parsed withJsonDocument, so it is trimming- and NativeAOT-safe. - The desktop shell translates window titles, menus, labels, tabs, placeholders, and tooltips after each window is realized. Data-bound values are left alone.
- Settings > General > UI language selects
system,en, orde.--locale <code>overrides the saved setting for one desktop launch;--list-localesprints the embedded catalogs in both executables. - CLI usage and error text are localized; machine-readable JSON stays in English.
- The translated smoke test records the active locale and first menu header (
locale=de,firstMenuHeader=Datei).
Metadata and media¶
metadata lookupdownloads a version-1 library-metadata catalog from an HTTP(S) orfile:URL, validates the version and 8 MB limit, writes a deterministic atomic cache, and searches by exact game ID, title, or normalized containment.metadata mediaattaches, detaches, or lists manual media files for a game. The desktop Game Metadata window can add, remove, and open the same attachments.- A lookup never blocks the library UI; a failed download falls back to the cache with a warning.
--writekeeps existing user attachments and the local disc path.
Physical optical drives¶
- File > Boot Optical Drive... lists attached CD/DVD drives with media and boots the selected disc through the host's cooked 2048-byte sector interface.
- Drive-root CLI paths (
D:,\\.\D:,/dev/sr0) are recognized byrun,info, and the other disc commands. Reads are read-only and never write to the disc. - Data discs boot like the equivalent image. CD-DA playback from a physical drive is not exposed yet because the source does not implement
ITrackedDiscSource.
Gamepads and controller preview¶
- Windows now enumerates legacy DirectInput/HID pads alongside XInput, including axes, POV hats, and calibrated triggers. XInput remains the fallback and Xbox pads are filtered from the DirectInput list so a device is never exposed twice.
- Input Bindings draws a 3DO pad diagram: mapped buttons are outlined, the selected row is amber, and a held key or gamepad control turns its button green.
--gamepad-probeprints the active source, connected controller count, and raw samples for hardware diagnosis.
Presentation¶
- Auto-crop borders in Settings > Video > Overscan uses 4DO's 25%-per-edge blank border detector and a one-second hysteresis. A manual or per-game crop overrides it. Only presentation and native screenshots change; hashes, audio, input, and save states are untouched.
- Display-sleep inhibition keeps the Windows display and system awake while a game is running and unpaused, and releases on pause, stop, fault, and exit. Linux and macOS remain best-effort because their compositors can still blank the display.
- Avalonia's
Unable to configure OpenGL FBOcompositor failure now falls back to the CPU presenter instead of reporting an unhandled UI exception every frame. The Vulkan surface also turns a resize failure into a clean presenter fallback.
TAS and 4DO state interop¶
FiveDo.Scriptingruns a hard-sandboxed MoonSharp Lua input script and emits frame-stamped controller entries.runandmovie recordaccept--input-lua;frame,hold,press, andreleaseare also available underinput.*.InputTimelineextracts player-1 changes from a movie, edits frames, exports a plain input script, and applies the result to a movie while preserving the embedded state and the other controller slots. CLI:movie timeline export|set|apply; desktop: Emulation > Input Timeline....state import-4domaps a FreeDOCore.4dosavinto a native 5DO state using a freshly reset machine as the base.state export-4dowrites the 32-bit 4DO container. ARM banks, memory (including the stock high-resolution mirrors), MADAM, CLIO, DSP, SPORT, VDLP, Quartz, and XBUS are mapped; unsupported fields are reported as warnings.- The 4DO path is explicitly best-effort and versionless/compiler-layout dependent. Native 4DO state compatibility is not a goal.
Fixes¶
- Library scanning no longer stops with
Not a valid Win32 FileTimewhen a removable or network volume reports a FILETIME outside theDateTimerange. The library and disc-health caches store an unknown stamp and do not re-hash the file on every scan. - External metadata records with a null title/path no longer match every lookup, null records are dropped on load, and user media attachments survive
metadata lookup --write. - An empty or unreadable physical optical drive now disposes its device handle before the domain error is reported.
- The DirectInput enumeration callback stays rooted for the native call.
- 4DO export now writes the 64-byte XBUS device-offset table required by FreeDOCore's loader; the record is structurally valid even when no device data is attached.
- Dependencies updated: Meziantou.Analyzer 3.0.340, CHDSharp 1.7.0, SkiaSharp 4.156.0, Microsoft.NET.Test.Sdk 18.12.0, and MoonSharp 2.0.0 for Lua input scripting.
Validation¶
- Full suite 2,252/2,252 passes in Debug with .NET SDK 11.0.100.
dotnet build,dotnet restore --locked-mode,dotnet format --verify-no-changes, and a clean-cachejb inspectcode --severity=WARNINGreport no warnings or errors.- Trimmed win-x64 single-file CLI and frontend publishes pass; the frontend smoke writes
FRONTEND SMOKE OK 1.9.0,locale=de,firstMenuHeader=Datei, andwindowState=Normal. - CI builds and tests on Windows, Linux, and macOS, publishes trimmed CLI/frontend single files, validates both NativeAOT apphosts, and produces the six release bundles.
- Each framework-dependent bundle contains the CLI, desktop app,
README.md,LICENSE,THIRD-PARTY-NOTICES.md,whatsnew.md, and the release/legal docs, with no runtime, PDB, or XML files.
Requirements¶
- The .NET 11 Runtime installed on the host. The bundles are framework-dependent and do not include the runtime. Choose the x64 or arm64 bundle that matches your OS.
- A legally obtained 1 MB 3DO BIOS ROM (for example
panafz1.bin). - Legally obtained 3DO disc images in ISO, BIN, CUE+BIN, CHD, or a compatible physical optical drive.
- Optional: network access for the online cover catalog and external metadata lookup. Local covers, the core emulator, and cached metadata work offline.
Download¶
| System | Bundle |
|---|---|
| Windows x64 | 5do-1.9.0-win-x64.zip |
| Windows arm64 | 5do-1.9.0-win-arm64.zip |
| Linux x64 | 5do-1.9.0-linux-x64.tar.gz |
| Linux arm64 | 5do-1.9.0-linux-arm64.tar.gz |
| macOS x64 | 5do-1.9.0-osx-x64.dmg |
| macOS arm64 | 5do-1.9.0-osx-arm64.dmg |
See the release page for SHA256SUMS.txt.
Known limits¶
- Playability follows the documented binary beyond-title rule, not a full playthrough.
- CD command cadence remains the residual differential on the 50-title panel.
- Windows x64 remains the validated GPU target; Linux GPU presentation under llvmpipe/SSH is preview/best-effort.
- Physical optical drive and DirectInput evidence still needs a host with the relevant hardware; automated tests cover parsing, translation, and the mapping policy.
- 4DO state import/export is best-effort and does not guarantee native 4DO state compatibility.
- Signing and notarization require a Windows certificate and an Apple developer account.