Changelog

Repairs the in-app updater (stray data folders could be installed instead of the new app) with a step-by-step recovery prompt; heals Switch classification after a version downgrade. Affected users need one manual install — see the update notice.

Groups Switch base games with updates and DLC; fixes a game info hang with an O(1) ROM index and background save-state scans; logs Metal validation errors in the XPC service instead of aborting under suyu/MoltenVK.

Custom core import with Switch/suyu support and vendored MoltenVK; 3D Pittman cabinet with fitted camera and TV toggle; CRTSim parity with pixel ratio and cabinet reflection controls; holo rainbow foil confined to the light spot with matched foil strength.

Save states survive database loss and re-adding games with stable game identity and orphan repair; TV mode fast scroll becomes a smooth carousel with icon-only system row and external-display prompt; reverse-holo foil parity with hue control; new CRT Pittman shader; titlebar notification ticker with contrast-safe playful buttons.

New Adaptive box art style that fits mixed portrait and landscape covers without cropping; guide sidebar keeps its position with GameCube and SDL pad support; TV mode restores the previous grid/list/holo view mode; plus core download sheet selection and refresh fixes.

Live controller test sheet with on-screen pad visualizer, remap, deadzone and calibration; OpenCritic review scores on the game detail view; library sort refactor with new "Time Played" and "Longer to Beat" orders; holo FX polish (reverse-foil transparency now correctly visible, fitted box-art alignment fixed for non-vertical covers, dead Holo settings pruned); TV mode 3D pivot on list rows plus wizard-style auto holo for the focused tile and selected hero; plus a bogus PC Engine CD001 magic header removed so DOS CD images no longer mis-identify as PCE.

HowLongToBeat completion times in the game detail view, plus a broad Holo performance pass — single-lock saliency cache, LRU-bounded holo caches, debounced async WebKit teardown, hover-gated mask decomposition — and a setup wizard with a live native Holo preview and multi-folder library management. (Holo effects are still in beta testing.)

Holo card effects — a liquid-glass sheen and glass-orb play button — plus a new hue-cycles setting that controls rainbow rotation as the cursor moves across a card, with effects suppressed during scrolling for smoothness; custom labels are now persisted to the per-game file and deletable per row, surviving reload and restart. (Holo effects are still in beta testing.)

Controller stick calibration with live per-direction range tuning and visual feedback, persisted per controller; the display and system stay awake while a game runs; live shader Apply survives relaunching the same game and TV Mode keeps the selected system after exit; SDL digital L2/R2 now drive analog triggers (Flycast) and duplicate controllers on reconnect are reconciled; plus a broad internal quality pass consolidating pause state into a single enum, single-source controller mappings, five-layer core-option precedence, and a new automated 11-ROM boot-smoke harness.

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.