Changelog

A release focused on input, shaders, and library ergonomics. DOS games can now see your joystick, with new configuration options and improved DOSBox-Pure controller-port handling; gamepad and TV Mode fixes make consecutive presses register reliably, the toolbar overlay works while another app is focused, and the Stop dialog can be confirmed with the A button; shader parameters that had no effect are greyed out, shader switching is faster, and composite/NTSC presets render correctly; plus custom box art from a local file, dynamic box art refresh, and pinch-to-zoom with live column reflow in the library grid.

Two-track release. Graphics/shaders: live in-game shader editor with unsaved-change confirmation, bezel reflection blurring into the CRT scanline/phosphor result for Famicom and RF displays, Slang preset grouping with SHA-256 stable IDs, a cached final-pass scaling flag, and an overscan default that keeps the full frame visible in RGBA conversion. Library & TV Mode: box art display modes with a blurred-fill background cache, a new GenreGroupingDiagram with per-genre counts, refreshed card/list-row context menus, clearer TV Mode settings copy across languages, and adjusted TV Mode tile/layout dimensions. Plus a full Japanese UI translation.

Feature release: renamable save state slots, recording sync across Time Machine rewinds, TV Mode screen selection, Wii controller toggle hotkey, RetroAchievements session/ping API, and TCC folder-scope management that stops the repeat Downloads permission prompt at launch.

Hotfix release: stops the launch-time crash introduced in 1.8.4 (libdispatch EXC_BREAKPOINT: trying to lock recursively) by guarding the AppSettingsCache initialization against the lazy-static dispatch_once re-entry when the logger warms up during first-launch SwiftData setup.

Hotfix release: TV Mode now correctly resumes the user's last session state (no more being dumped back into TV Mode after quitting in normal mode), plus bundled controller presets and an export script for default gamepad mappings.

Patch release: fixes silent save-state deletion failures (composite key mismatch, #27) and false-positive update-notifications on the current version (#25), plus a TV-mode game-loading reliability pass and a broad Swift 6 warning cleanup.

Patch release: TV Mode fresh-play on Y for save-state ownership, per-launch auto-load override that preserves the global preference, "game wins over app" gamepad navigation hierarchy for shared combos, and reliable key-window restoration after settings sheet dismissal in fullscreen TV Mode.

Patch release: controller management overhaul with multi-player keyboard mapping, gap-slot prioritization, and SDL disable/reset controls; TV Mode enhancements including filter sync, sort mode, short-list mode, resolution-adaptive scaling, and core download overlay; RetroAchievements cache fix and RA Hash display.

Feature release: TV Mode browsing with animated backgrounds and box-art focus, revamped box-art pipeline, RetroAchievements enable prompt and import progress, rewind & XPC reliability fixes (including #20), type-to-search and smart collections, refactored LCD grid shaders, and ROM-scanning/metadata caching.

Maintenance release: PPSSPP asset downloads, asynchronous inline box art in the core download sheet, cheat crash recovery improvements, library sidebar and grid search with game-card subtitles, and new settings options.

Safety-net release: automatic pre-migration backup of the SwiftData store plus an "App Update Mode" recovery screen, so a future breaking migration can never silently wipe user data. On failure, data is restored from a timestamped backup and the app launches in limited mode.

Critical hotfix: updating from v1.6.0 to v1.7.0 could delete the entire TruchiEmu user-data folder. v1.7.1 fixes the schema migration so user data is preserved and narrows the recovery path so it never touches the data folder.

Time Machine playback controls (rewind, fast-forward, slow motion), Famicom RF NTSC decoder shader, Update Wizard, LaunchBox metadata enrichment, grid/sidebar redesign, and broad build-warning cleanup.

Streaming settings overhaul with Twitch/YouTube/custom stream key verification, share button & save last moments hotkeys, bezel toggle, hash data download, settings navigation rework with scoped sections and back chip.

In-game screenshots (with flash + pill + Reveal in Finder), controller hotkey mapping, save manager bulk-delete, test notification action, notification pill refinements.

Emergency patch: librashader dylib fix for release builds, notification test action, save manager bulk-delete, documentation cleanup.

Streaming & recording, SDL controller support, ~1800 new slang shaders, training mode frame data, box art region selection, macOS Game Mode.

Full gamepad navigation, smart ROM deletion with file restoration, joystick toggle, library grid context menus and scroll state persistence.

Training mode overhaul, region-specific box art, in-app help sheet, system icon improvements, Sega input overrides, extensive fixes.

Compressed ROMs (ZIP/7z/RAR), MAME/FBNeo disambiguation, CRC/ boot-sector identification, system merging, major bug fixes.

Accessibility improvements to text-on-accent contrast, default theme changed to Mega Man.

First stable release! RetroAchievements integration, game guide sidebar, controller deadzone settings, Jaguar BIOS, ISO scanning overhaul.

Analog mouse support, training mode & move lists, notification system, genre management, progressive save states, update checker, box art improvements.

XPC service architecture, game loading overlay, core options override hierarchy, Portuguese localization.

16 accent color themes, MAME input mapping, 8 new systems, Portuguese language support.

Fixed broken analog triggers on Dreamcast.

Full English and Spanish localization, zoomable box art, Dolphin stability fixes, settings refactoring.

GBC shader improvements, ROM identification fixes, system rename, Dreamcast BIOS handling, mGBA core stability.

RetroAchievements integration, Saturn emulation, massive cheat database, CRT shader improvements, documentation site launch.

Performance optimizations, core options improvements, MAME gaming improvements, genre categorization.

UI/UX refinements, Game Boy shader improvements, app speed optimizations, core options management.

CRT and Game Boy shaders, right-click library menus, PS1/PS2/MAME stability, Game Boy Color shader.

Offline ROM identification resources, automated ROM detection improvements, system categorization fixes.

Initial public release: native macOS SwiftUI app, Metal shader engine, library management, RetroAchievements, wide system support.