Nintendo Switch emulator for Mac, natively running on Apple Silicon.
To be completed before publication: logo, link verification. Download link to confirm (binary name not explicit).
Last updated:
Platforms
Architecture
Mac OS X - macOS
Apple Silicon
Download and links
- Download truchiEmu
- Source code 60 GitHub stars
- License : MIT
Version history
1.16.1
- Les paramètres de shaders pour chaque système sont désormais conservés après une mise à jour de l'application.
- Les présets Slang sont stockés en chemins absolus et sont désormais réévalués après une mise à jour ou un déplacement de l'application.
- Correction des entrées pour les cœurs exécutés via le service XPC sans mémoire partagée.
- Les catégories intelligentes affichent correctement l'état des systèmes dans l'onglet "Systèmes".
v1.16.1
Fix release: shader settings no longer revert across app updates (issue #41), plus an input fix for XPC-hosted cores and a smart-category display fix.
Highlights
- Shader settings now survive app updates: The per-system shader selection (and per-system core default, visibility, and custom names) is no longer wiped when the app updates. Previously, any release that shipped an updated system database deleted the local settings cache, and every system fell back to its bundled default — shader selections quietly reverted to CRT Classic (issue #41). Note: if v1.16.0 already reset your selections, set them once more — from now on they persist.
- Slang shader selections are more resilient: Slang presets are stored as absolute paths, which stopped resolving when the app bundle moved or the bundled slang-shaders tree changed between versions. The launcher now re-resolves those paths against the current install, so a stored slang selection keeps working after an update or a move of the app.
- Input fix for XPC-hosted cores: When a core runs in the XPC service without shared memory, opening the game toolbar could leave analog sticks and analog buttons stuck at their last value. All inputs are now fully released for that configuration too.
- Smart categories — Systems sheet matches real membership: In a multi-system smart category that follows newly activated systems, a system that became active after the category was saved showed as disabled in the Systems sheet even though its games were members. The sheet now shows its true state.
Full changelog: https://juanchojuancho.github.io/truchiemu/changelog/v1.16.1.html
1.16.0
- Ajout de trois nouvelles familles de shaders : Morph CRT (simulation physique de tube cathodique avec NTSC/PAL), CRT Shader pack (reconstruction multi-pass avec effets optiques), et Glyph Text (affichage en grille de glyphes monospacés adaptatifs).
- Implémentation de Smart categories pour sauvegarder des recherches dynamiques (filtres par système, genre, ou jeux exclus/inclus) avec prévisualisation en temps réel.
- Réorganisation de la bibliothèque avec tri alphabétique (A–Z) et par année, ainsi que des en-têtes collapsibles par système affichant icône, année de sortie et nombre de jeux.
- Optimisation majeure des performances : démarrage accéléré (4x plus rapide sur bibliothèques volumineuses), suppression des lag de défilement et compilation hors-thread des chaînes de shaders slang.
- Correction des fuites d'entrée (clôture de barre d'outils, conflit entre START et le noyau, réinitialisation logicielle A+B après utilisation du pad).
- Restauration des icônes de menu sur macOS 27 et suppression des fuites de boxarts entre cartes recyclées.
New shaders — with props where props are due
The built-in shader library grows to 23 presets, with three new families:
- Morph CRT — physical CRT simulation with a full analog signal path (composite encode/decode, NTSC/PAL carrier artifacts), dynamic scanlines, phosphor glow, curvature, and convergence. Inspired by PixelFX Morph 4K v4.
- CRT Shader pack (Reference, Clean, Soft, Photo Soft) — Metal port of crt-shader by Brooklyn (OutThisLife), a multi-pass CRT reconstruction with horizontal beam spread, phosphor mask, and optics passes (live demo). Credit lives in Settings → About.
- Glyph Text — renders your game as a grid of monospaced glyphs (ASCII, Extended Latin/Greek/shading, or Blocks); density follows luminance, with source colors or a phosphor tint.
Highlights
- Smart categories: Save any library search as a dynamic category — search terms, systems, filter chips, genres, and per-game include/exclude overrides, with a live match preview. Multi-system categories follow newly active systems.
- Grouped library: New System (A–Z) and System (by year) sorts with collapsible per-system headers showing icon, launch year, and game count. Each category remembers its own sort and view mode.
- Redesigned game toolbar: Configurable layout; Save writes to the active slot in one click, Load opens a compact 5×2 save-state browser with previews. The active slot persists across launches.
- Performance overhaul: Warm startup on a 2000+ ROM library is roughly 4× faster (async launch pipeline, byte-packed display cache, deferred non-UI work). Scroll jank eliminated across grid, holo, list, and row modes; slang shader chains compile off the main thread.
- Sharper screenshots: Capture crops to the centered game area — no more black bars baked into screenshots. Bezel-style slang chains keep their full-frame layout.
Fixes
- Input leaks: toolbar-close press, toolbar combo (START no longer reaches the core), A+B soft reset after gamepad toolbar use
- Library: single-system cores no longer lend extensions to other systems (NES no longer claims .gb), boxart leaks between recycled cards, missing boxart after manual add, game titles losing spaces, renames not refreshing the grid, double-launch debounce
- Holo: hover freeze after scroll, pinch-zoom card shuffle
- Slang: frame count/direction/FPS/aspect/frametime uniforms, legacy parameter detection, patched librashader runtime for final-pass feedback and scaling
- macOS 27: menu item icons restored
Full details: English changelog · Español · Português
1.15.2
- Correction majeure du système de mise à jour intégré pour éviter la copie erronée de dossiers dans /Applications.
- Ajout d’une procédure de récupération guidée en cas d’échec de mise à jour, accessible depuis le lancement.
- Restauration automatique des colonnes de classification Switch après un retour en arrière de version.
- Détection et gestion des doublons ou copies corrompues de l’application lors du démarrage.
v1.15.2
Patch release: repairs the in-app updater, adds a step-by-step recovery prompt for failed updates, and heals Switch classification after a version downgrade.
Update Notice — read this if an update since v1.14.0 never changed your version
A bug in the updater could copy a stray data folder (for example com.apple.WebKit.Networking+com.TruchiEmu.app) into /Applications instead of the new app. The app then restarted on the old version, and a blank app icon may sit in /Applications. This release fixes the updater and detects the damage, but affected users need one manual install:
- Quit TruchiEmu.
- In Finder, move the stray blank item to Trash. Delete nothing else.
- Download
TruchiEmu-v1.15.2.zipbelow. - Unzip it and move
TruchiEmu.appto/Applicationswith Replace. - Launch from
/Applicationsand check the version in Settings About. One manual install restores auto-update for all later versions.
Highlights
- In-app updater repair (#40): updates extract into a unique staging folder, the installer picks
TruchiEmu.appby exact name and validates its bundle ID and executable (decoy folders are ignored), copy failures surface as errors instead of fake success, the app updates where it runs from, and relaunch goes throughNSWorkspace. - Update recovery prompt: on launch the app scans
/Applicationsfor stray leftovers, broken copies, and split installs, then shows Finder-based step-by-step repair with a reinstall-from-running-copy button. A manual "Update health" check lives in Settings About. Nothing is ever auto-deleted. - Switch heal after downgrade: launching an older build used to wipe Switch classification columns; stale rows are now reclassified at launch.
1.15.1
- Ajout d’un regroupement automatique des jeux Nintendo Switch et de leurs mises à jour/DLC via des identifiants précis (XCI, tickets, noms de fichiers).
- Suppression du blocage du thread principal lors de l’affichage des infos sur un jeu, grâce à un index ROM optimisé et à des scans de sauvegardes en arrière-plan.
- Redirection des erreurs de validation Metal vers le service XPC pour éviter les plantages sous suyu/MoltenVK.
This patch release groups Switch base games with their updates and DLC, fixes a game info hang, and logs Metal validation errors in the XPC service instead of aborting under suyu/MoltenVK.
Highlights
- Switch updates and DLC grouping: Switch files are classified as base, update, or DLC via the suyu core's own FileSys classes (exact title IDs, including XCI), with ticket and filename fallback. Updates and DLC group under one library card with enable toggles in the detail view; direct launch of add-ons is blocked.
- Game info hang fix: Adds an O(1) ROM index and moves save-state scans to the background after sampling showed a 17s main-thread burn when opening game info.
- Metal validation in XPC service: Metal validation errors are logged instead of aborting, fixing crashes under suyu/MoltenVK.
1.15.0
- Ajout du support d'import de cœurs personnalisés (fichiers zip/dylib) avec gestion des bibliothèques, signature binaire et mappage système, incluant une entrée pour la Nintendo Switch et des vérifications de clés/firmware pour suyu.
- Intégration de MoltenVK en version embarquée pour les cœurs Vulkan en mode headless via la variable LIBVULKAN_PATH.
- Cabine 3D Pittman avec écran et cadre en maillage, caméra intégrée et bascule pour mode TV, inspirée de CRTSim.
- Parité avec CRTSim pour le contrôle du ratio de pixels, des réflexions de la cabine, du bloom divisé et des champs NTSC stables.
- Amélioration des effets holographiques : confinement du foil arc-en-ciel à la zone lumineuse et ajustement de la force du foil aux images générées.
This release adds custom core import with Switch/suyu support and vendored MoltenVK, ships a 3D Pittman cabinet with fitted camera and TV toggle, brings CRTSim parity with pixel ratio and cabinet reflection controls, and tightens holo rainbow foil with light-spot confinement and matched foil strength.
Highlights
- Custom core import: Import generic zip/dylib cores with companion library handling, binary signing, and system mapping. Adds a Switch database entry, per-system import entry points, suyu keys/firmware checks, and MoltenVK provisioning via LIBVULKAN_PATH for headless Vulkan cores.
- Pittman 3D cabinet: Mesh screen and frame with fitted camera and a TV toggle for a cabinet-style presentation. Based on CRTSim by J. Kyle Pittman (Minor Key Games), CC0 1.0.
- CRTSim parity: Pixel ratio control, cabinet reflection controls, split bloom, and stable NTSC fields.
- Holo foil polish: Rainbow foil confined to the light spot with full dark hiding the foil, and image foils matched to generated foil strength.
Detailed Changes
- Cores — custom core import with Switch/suyu support and vendored MoltenVK
- Shaders — CRTSim parity: pixel ratio, cabinet reflection controls, split bloom, stable NTSC fields
- Cabinet — Pittman 3D cabinet: mesh screen and frame with fitted camera and TV toggle
- Holo FX — rainbow foil confined to light spot; image foils matched to generated foil strength
1.14.0
- Identité de jeu stable : les états de sauvegarde survivent à la perte de la base de données et à la réajout de jeux via une clé stable (hash de contenu prioritaire, nom de fichier en fallback).
- Mode TV amélioré : défilement fluide en carrousel avec une ligne d’icônes uniquement et une détection automatique de l’affichage externe.
- Parité des effets "reverse-holo" : ajout d’un curseur de teinte pour ajuster les nuances des effets de foil holographique.
- Nouveau shader CRT Pittman : implémentation d’un rendu CRTSim avec passes composite, masque et bloom.
- Barre de titre interactive : affichage de notifications sous forme de pastilles animées avec boutons contrastés et effets visuels.
v1.14.0
This release makes save states survive database loss and re-adding games with stable game identity and orphan repair, turns TV mode fast scroll into a smooth carousel with an icon-only system row and external-display prompt, adds reverse-holo foil parity with a hue control, ships a new CRT Pittman shader, and adds a titlebar notification ticker with contrast-safe playful buttons.
Highlights
- Stable game identity: Save states now survive database loss and re-adding games. A stable key (content hash first, filename stem fallback) replaces the random UUID, legacy keys merge on read, orphans auto-relink with manual repair, a new Orphaned Saves section in Save Manager offers single and bulk delete, and favorites/playtime/core choice/categories get an external metadata backup with a versioned one-shot migration.
- TV mode carousel + icon row: L1/R1 and L2/R2 fast scroll runs as chained unit steps with overlapping linear motion and continuous center focus, the systems row goes icon-only with an enlarged center icon, system flights defer the games refresh to the drain with a fade-in, and TV mode prompts to move to an external display.
- Reverse holo parity + hue slider: Denser rainbow foil with random-mode hue parity, corrected rainbow transparency and punch, and solid/background visibility, plus a hue slider control.
- CRT Pittman shader: New CRTSim port with composite, mask, and bloom passes.
- Titlebar notification ticker: Queued notification pills with icon spin in the titlebar.
- Contrast-safe playful buttons: Computed button text for contrast safety, playful hover states, and deep selected fills; plus a playful delete confirm with instant box art, shake and bounce on arm.
1.13.0
- Ajout d’un quatrième style d’art de boîte Adaptive, adaptant les couvertures portrait/paysage sans les couper, avec fond flouté et étiquettes multilingues (en/es/pt/ja).
- Mémorisation de la position de la barre d’aide et support des manettes GameCube et SDL.
- Restauration du mode d’affichage (grille/liste/hologramme) en mode TV après retour à l’interface principale.
- Correction des erreurs de téléchargement des cœurs : sélection fonctionnelle sans lien externe et suppression du faux message noCoresFound.
This release adds a fourth Adaptive box art style that fits mixed portrait and landscape covers without cropping, keeps the guide sidebar position in memory with GameCube and SDL pad support, fixes TV mode to restore the previous grid/list/holo view mode, and fixes core download sheet selection and refresh errors.
Highlights
- Adaptive box art style: A new fourth
BoxTypefits each game's art inside the card with a blurred fill, so mixed portrait/landscape covers are no longer trimmed by the forced per-system aspect. Card frames keep the system default aspect to preserve the uniform grid layout. Labels are localized across en/es/pt/ja. - Guide sidebar memory + GC/SDL pads: The guide sidebar keeps its position in memory, with support for GameCube and SDL pads.
- TV mode restores view mode: TV mode now saves and restores the previous grid/list/holo mode instead of resetting it.
- Core download sheet fixes: Core selection now works when no external binding exists, and refresh no longer shows a false
noCoresFounderror when cores are available.
Detailed Changes
- Library grid — new Adaptive box art style for mixed-orientation covers (#36)
- Guide — keep guide sidebar position in memory; add support for GC and SDL pads
- TV mode — fix view mode save to restore previous grid/list/holo mode
- Core download sheet — fix selection and
noCoresFoundrefresh error
Full changelog: https://juanchogithub.github.io/truchiemu/changelog/v1.13.0.html
1.12.0
- Ajout d’une feuille de test des manettes en temps réel avec visualisation visuelle des pads, remappage, ajustement des zones mortes et calibration.
- Intégration des scores OpenCritic dans la vue détaillée des jeux, avec affichage des notes, niveaux, pourcentage de recommandation et lien profond.
- Refonte du système de tri de la bibliothèque avec ajout des options "Temps passé" et "Plus long à compléter".
- Correction de la transparence des effets holographiques inversés et alignement des box-arts dans les cartes d’affichage.
- Suppression d’un en-tête magique erroné pour les images DOS CD, évitant une fausse identification des jeux PC Engine CD001.
v1.12.0
This release adds a live controller test sheet with on-screen pad visualizer, remap, deadzone and calibration, brings OpenCritic review scores to the game detail view, refactors the library sort picker with new "Time Played" and "Longer to Beat" orders, and polishes the holo FX pipeline: reverse-foil transparency is now correctly visible, fitted box-art alignment is fixed for non-vertical covers, dead Holo settings are pruned, and TV mode gets a 3D pivoting effect on list rows plus a wizard-style auto holo for the focused tile and selected hero. A bogus PC Engine CD001 magic header is removed so DOS CD images no longer mis-identify as PCE.
Highlights
- Live controller test sheet: An auto-presented sheet on new gamepads (and a manual "Test Controller" entry in settings) shows the current binding layout on a SwiftUI-drawn Xbox layout, lets the user remap face/shoulder/trigger/stick/dpad buttons, adjust stick deadzones, and run a stick calibration session. Conflicts are highlighted in yellow.
- OpenCritic integration: The game detail view now shows critic score, tier, percent recommended, review count, and a deep link. Results are cached in
ROMMetadata; the API key and connectivity test live in Settings, and everything is localized across en/es/ja/pt. - Library sort refactor + new orders: The legacy two-boolean sort is replaced by a single
LibrarySortOrderenum, with "Time Played" (bytotalPlaytimeSeconds) and "Longer to Beat" (byhltbMainStoryHours) added in the chip bar's "Other" popover. Pills now cycle inactive → descending → ascending with directional arrows. - Holo FX polish: Reverse-holo foil transparency is correctly visible in the bright mid-tones (new
ReverseHoloMaskMetal shader with luminance gating), fitted box art and holo foil are centered in the fill-blurred all-games card, nine dead Holo settings are pruned, and TV mode gets a 3D pivoting effect on list rows plus an auto-holo on the focused tile and selected hero.
See the full changelog at https://truchiemu.app/changelog/v1.12.0.html
1.11.0
- Ajout des estimations de temps de complétion HowLongToBeat dans la vue détaillée des jeux (Main, Main + Extra, Completionist).
- Correction d’un deadlock dans le cache des masques Holo et optimisation des caches LRU pour tous les éléments visuels (tiles, motifs, ombres, textures).
- Amélioration du scrolling fluide dans les bibliothèques de plus de 50 cartes Holo via un décalage asynchrone de WebKit et une réduction des observations globales.
- Intégration d’un aperçu natif Holo en temps réel dans le wizard de configuration, avec gestion multi-dossiers et sélection de région améliorée.
- Traduction des statistiques de jeu (durée totale, nombre de parties, dernière session, réalisations) en es/pt/ja en plus de l’anglais.
v1.11.0
This release adds HowLongToBeat completion-time estimates to the game detail view and hardens Holo card effects for big libraries: a deadlock in the mask cache is fixed, all holo caches are LRU-bounded, and the WebKit teardown is debounced so it no longer freezes the grid mid-hover. Scrolling a 50+ card holo collection is now smooth. The setup wizard gains a live native Holo preview that matches the in-app effect, multi-folder library management with removal reconciliation, and a sharper region selector.
Note: Holo effects are still in beta testing. They are experimental and may change or be refined in future releases.
Highlights
- HowLongToBeat completion times: The game detail view now shows Main, Main + Extra, and Completionist estimates from HowLongToBeat, with automatic matching for titled ROMs and a search sheet for manual selection.
- Holo performance pass: Holo mask decomposition only runs on actual hover (not on card appearance), HoloSaliencyService is now protected by a single lock (fixes a deadlock that froze the app during scroll), and all holo caches (foil tiles, pattern store, saliency masks, bump textures) are LRU-bounded.
- Smoother scroll in the holo grid: The library's scroll state only republishes on real change, individual cards no longer observe the global saliency service, and WebKit teardown is debounced and async so it never interrupts a scroll gesture.
- HoloWebCardView cleanup: A single shared WKProcessPool, quantized frame sizes, lazy mount only when active, and fully async
deinitcleanup. - Setup wizard v2: Live native HoloPreviewCard in the region selector, multi-folder library list with reconciliation, bezel moved into Optional Features, and the default shader picker is gone.
- Localized game statistics: Total playtime, plays, last played, and achievements are now translated across en/es/pt/ja, plus an
onPlayaction onGameListRowView.
Detailed Changes
- HowLongToBeat integration —
ROMMetadataEntrygains HLTB fields (game ID, matched title, completion time estimates),HLTBWebSearchSheetfor manual selection,HowLongToBeatCardwith auto and manual matching, and integration into the game detail view's overview. - Holo saliency deadlock fix —
HoloSaliencyServicenow uses a singleOSAllocatedUnfairLockfor both entries and LRU order; the previous two-lock design could deadlock during scroll. - Holo LRU caches —
HoloFoilTileCache(32),HoloPatternStore(64/32/32),HoloSaliencyService(100),HoloBumpRenderer(16);DetailBoxArtComponentsquantizes render sizes to 0.5pt buckets to prevent fragmentation. - Holo scroll lag fixes —
LibraryScrollState.isScrollingonly republishes on real change;HoloGameCardViewno longer observesHoloSaliencyService(each card uses local@Statefor its own progress); mask decomposition is gated on a hover-trigger so it does not run for all visible cards. - HoloWebCardView —
WKWebViewis only created whenisActiveis true; teardown uses a debouncedscheduleUnmount(0.35s, cancel-on-rehover) plus fully asyncdeinit; all card webviews share oneWKProcessPool;loadKeyuses quantized 0.5pt frame buckets to stop reload thrashing. - HoloFoilLayers — luminance masking for a more accurate metallic effect.
- Wizard —
HoloPreviewCardnow uses the nativeHoloFoilLayers+HoloSheenEffect+HoloScratchLayerpipeline, ratio-aware, hover-aware; pre-bundled hero masks for the region selector; multi-folder library list with DB reconciliation; bezel moved to Optional Features. - BoxArt —
BoxArtLayersno longer pre-subtracts the title from the hero blob (the title hint was removing a title-shaped notch at full resolution); the wizard region selector uses Zelda OoT US/EU/JP samples to exercise aspect-ratio variation. - Localization — total playtime, plays, last played, and achievements translated across en/es/pt/ja; bezel feature entries localized; new Holo translations.
- Bump marketing version to 1.11.0 and build number to 34 across
project.yml, bothInfo.plists, anddocs/_config.yml.
1.10.0
- Ajout des effets Holo (beta) avec un rendu liquide-verre pour les cartes et un bouton de lecture en forme d’orbite transparente.
- Paramètre hueCycles pour contrôler le nombre de rotations arc-en-ciel sur les cartes lors du survol, avec suppression des effets pendant le défilement.
- Persistance des cheats personnalisés dans le fichier .cht par jeu, avec possibilité de suppression par ligne, survivant aux rechargements.
- Support des traductions pour le paramètre Holo en espagnol, japonais et portugais (ajouté à l’anglais existant).
v1.10.0
This release brings the Holo card effects — a liquid-glass sheen and glass-orb play button — alongside a new hue-cycles setting that controls how many rainbow rotations play across a card as the cursor moves, with effects suppressed during scrolling for smoothness. Custom cheats are now persisted to the per-game file and can be deleted per row, surviving reload and restart.
Note: The Holo effects are still in beta testing. They are experimental and may change or be refined in future releases.
Highlights
- Holo effects (beta): A new liquid-glass sheen view modifier and a glass-orb play button bring a dimensional, glassy look to library cards and controls. Still in beta testing and subject to change.
- Hue cycles setting: A new Holo setting controls how many rainbow hue rotations sweep across a card as the cursor moves, with translations in English, Spanish, Japanese, and Portuguese.
- Smoother scrolling: Holo effects are now suppressed while the library is scrolling, keeping interaction fluid on large collections.
- Persistent custom cheats: Custom cheats are written to the per-game .cht file and survive reload and app restart, and each cheat row now has a delete button.
Detailed Changes
- Add Holo feature support and UI enhancements — LiquidGlassSheen view modifier and GlassOrbPlayButton, Holo settings wired into Spanish/Japanese/Portuguese translations, BoxArtService resets holo masks when box art updates, the BoxArtLayers dependency added to the project, plus a bounding-box analysis script.
- feat: add hue cycles setting for Holo effects — HoloSettingsStore and HoloSettingsSnapshot gain a hueCycles value; HoloGameCardView suppresses effects during scrolling; HoloBumpRenderer handles invalid texture sizes gracefully; translations added across languages.
- fix: persist and allow deletion of custom cheats — CheatManagerService.addCheat/removeCheat persist to the per-game custom .cht file so custom cheats survive reload and restart; a delete (trash) button added to each cheat row; CheatAutoLoader.saveCustomCheats simplified to write a single canonical .cht per game (fixes #34).
- Bump marketing version to 1.10.0 and build number to 33 across project.yml, both Info.plists, and docs/_config.yml.
1.9.0
- Ajout d’un calibrage des sticks analogiques par contrôleur avec rétroaction visuelle en temps réel et sauvegarde des paramètres par périphérique.
- Maintien de l’écran et du système éveillés pendant le jeu pour éviter les coupures liées à la mise en veille.
- Persistance des modifications appliquées via l’éditeur de shaders en direct après relancement du même jeu.
- Conservation du système sélectionné en mode TV après la sortie d’un jeu, au lieu de revenir à la liste récente.
- Correction des contrôles SDL : les boutons L2/R2 numériques activent désormais les déclencheurs analogiques (ex. : Dreamcast dans Flycast).
- Réconciliation automatique des contrôleurs dupliqués après reconnexion via GameControllerKit.
This release adds controller stick calibration and a broad internal quality pass. Controllers: calibrate the analog stick range of each controller with live visual feedback, persisted per controller, plus fixes for SDL controllers — digital L2/R2 now drive analog triggers for cores like Flycast, and duplicate controllers after a reconnect are reconciled. While a game runs, the display and system stay awake. The live shader editor's Apply now survives relaunching the same game, and TV Mode keeps the system you selected after exiting a game. Under the hood, pause state was consolidated into a single enum (fixing scrub and recording bugs), core options follow a single five-layer precedence walk, controller mappings share one source of truth, and a new automated smoke-test harness boots 11 ROMs through the real launch pipeline to verify stability.
Highlights
- Stick calibration: Calibrate each controller's analog stick range per direction with a live calibration session and visual feedback, applied to all your games and persisted per controller.
- No sleep while gaming: The display and system are kept awake while a game is running, so play sessions are never interrupted by your Mac falling asleep.
- Live shader Apply persists: Shader changes applied with the in-game shader editor survive relaunching the same game instead of reverting to the stale snapshot.
- TV Mode keeps its system: After exiting a game, TV Mode stays on the system you selected rather than snapping back to Recent.
- SDL controller fixes: Digital L2/R2 buttons now drive the analog trigger state (fixing Dreamcast controls in Flycast), and duplicate controllers are reconciled when GameControllerKit reconnects a device SDL already accepted.
- Consolidated pause state: Rewind, scrub, and pause now share a single state machine — scrubbing over a paused game keeps it paused on exit, and gamepad navigation restores the prior pause state.
- Automated smoke tests: A new boot-smoke harness launches 11 ROMs (NES to MAME) through the real launch pipeline and asserts the first frame renders, with the slang shader audit still healthy.
Full changelog: https://github.com/JuanchoGithub/truchiemu/blob/main/docs/changelog/v1.9.0.html
1.8.8
- Ajout du support des manettes DOS avec configuration personnalisable (préréglages, bascule via hotkey) et amélioration du routage des ports de contrôleur pour DOSBox-Pure.
- Paramètres de shaders inefficaces désactivés dans l’interface, chargement asynchrone des paramètres avec indicateur de progression.
- Intégration de la rotation par pincement sur la grille de bibliothèque avec réorganisation dynamique des colonnes.
- Correction des problèmes de rendu des shaders CRT (préréglages composite/NTSC comme ntsc-md-rainbows fonctionnent correctement).
- Ajout d’un système de handoff vers un écran externe avec phase de préchauffage et sélection automatique de l’écran en mode TV au premier lancement.
- Amélioration des entrées gamepad (enregistrement fiable des appuis consécutifs, activation du menu contextuel en arrière-plan, confirmation du dialogue d’arrêt via bouton A).
A release focused on input, shaders, and library ergonomics.
Input & TV Mode: DOS games can now see your joystick, with new configuration options, improved controller-port handling for DOSBox-Pure and better mouse-click monitoring. Gamepad fixes make consecutive presses register reliably, the toolbar overlay (L3+R3 / Start+Select) works while another app is focused, and the Stop dialog can be confirmed with the A button in TV Mode. TV Mode also picks the right screen on first launch, and a new external display prompt hands the game over with a brief warm-up before the switch.
Shaders: Shader parameters that had no effect are now greyed out, switching between complex shaders is faster with a spinner instead of a blank panel, and presets that emulate composite/NTSC video now render the way they should.
Library: Custom box art from a local file, dynamic box art refresh across the library, and pinch-to-zoom with live column reflow in the library grid.
Highlights
- DOS games can now see your joystick: Your connected controller is now visible to DOS games via DOSBox-Pure, with new options to pick the joystick preset per game or system, a hotkey to toggle it, and improved controller-port and mouse-click handling.
- Only working shader sliders shown: Shader parameters that had no effect on the picture are now greyed out — you only see sliders that actually change something.
- Faster shader switching: Switching between complex shaders no longer shows a blank "No parameters" panel; parameters load in the background with a spinner.
- Fixed CRT shader rendering: Presets that emulate composite/NTSC video (like
ntsc-md-rainbows) now render the way they should. - Custom box art: Set your own box art from a local file, and box art now refreshes dynamically across the library.
- Pinch to zoom the library: Trackpad pinch zoom with live column reflow in the library grid.
- External display handoff: Connect a display and TruchiEmu offers to move the game over, with a brief warm-up before the switch — and TV Mode now picks the right screen on first launch.
- Gamepad & TV Mode fixes: Consecutive button presses register reliably, the gamepad toolbar (L3+R3 / Start+Select) works while another app is focused, and you can confirm the Stop dialog with the A button in TV Mode.
- Hotkey polish: New fullscreen toggle, Escape hint when the keyboard is captured, a stable hotkey-row layout, and app hotkeys disabled while keyboard is captured for DOS/ScummVM.
- Stability: Stopping a game no longer freezes the app while iCloud is syncing files.
- Menu bar icons: Custom menu bar items now show proper icons instead of plain text.
Detailed Changes
- feat: add DOS joystick support and configuration options —
DOSJoystickPresetenum, AppSettings persistence,DOSJoystickSettingsViewwired into GameDetailView, hotkey toggle, en/es/pt/ja translations, XPC bridge support for DOS joystick types - feat: enhance controller port device handling for DOSBox-Pure and improve mouse click monitoring
- fix: disable inert slang shader parameters in UI — compute consumed-names set once per chain, stamp
ShaderUniform.disabled, cache by preset path + mtime fingerprint - feat: implement async reflection for slang presets in ShaderManager and ShaderEditorSidebar; subsequent fixes land in later commits
- feat: show loading indicator while shader parameters reflect —
isReflectingParametersstate inShaderPresetPickerViewandShaderEditorSidebar; reflection failure can no longer leave the spinner stuck - fix: route
scale_type=sourceslang presets through a source-sized intermediate —hasSourceSizedFinalPassdetection,needsSourceSizedIntermediate, pinned to.bgra8Unormto satisfy Metal validation - feat: implement source-sized offscreen texture handling for PassFeedback chains and enhance the rendering pipeline
- feat: point slang-shaders submodule to a fork with macOS path fixes
- feat: enhance ShaderEditorSidebar with ScrollViewReader for scroll position restoration
- fix: clear per-game shader override when accepting the system shader
- feat: add local file picker for box art and update translations
- feat: integrate BoxArtService for dynamic box art updates in UI components
- feat: smooth pinch zoom with live column reflow in the library grid
- feat: add external display prompt with warm-up pill and game handoff
- fix: resolve TV mode cold-start screen selection after window is up
- fix: clear stale gamepad nav button state when all buttons released — reset transient poll state on the idle path so repeated presses produce rising edges
- fix: gamepad toolbar context outranks TV mode nav so Stop confirm receives the A press
- fix: trigger gamepad toolbar overlay (L3+R3 / Start+Select) while the app is not focused — bypasses the key-window filter that silently paused the runner
- feat: add fullscreen toggle hotkey and update translations
- feat: add escape hint functionality and update translations
- fix: keep hotkey row layout stable when reset and clear buttons appear
- fix: disable app hotkeys while keyboard is captured for DOS/ScummVM
- refactor: simplify card background and stroke color logic in GameCardView
- feat: add SF Symbol icons to all custom menu bar items
- fix: prevent UI freeze on game stop from iCloud materialization — async XPC proxy with real timeout, launch-time materialization off the connection queue, shared directory-walk budget
1.8.7
- Ajout d’un éditeur de shaders en temps réel dans une barre latérale, avec confirmation des modifications non enregistrées et synchronisation automatique des paramètres dans les présets.
- Intégration d’une traduction complète de l’interface utilisateur en japonais (ja.json), disponible dans le menu de langue et lors de la compilation Xcode.
- Fusion des reflets de bezel avec les effets de scanlines/phosphor pour les écrans Famicom et RF, avec des paramètres ajustables (rayon, glow, flou) et une stabilité améliorée du masquage.
- Optimisation des performances graphiques : cache des uniformes conditionné par génération, alignement des scanlines/masques phosphor, cache de l’aspect ratio et optimisation du resampling audio.
- Nouveaux modes d’affichage des box arts avec fond flouté dynamique, intégrés dans les vues GameCardView, GridCollectionView et LibraryGridView.
- Diagramme de regroupement par genre (GenreGroupingDiagram) avec comptage par genre, et amélioration des menus contextuels des cartes et listes.
Two-track release.
Graphics/shaders: a live in-game shader editor with unsaved-change confirmation, bezel reflections now 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, an overscan default that keeps the full frame visible in RGBA conversion, and a rendering performance pass (generation-gated uniform cache, aligned phosphor mask/scanlines, cached aspect ratio, optimized audio resampling, visibility-gated overlay timers).
Library & TV Mode: box art display modes with a blurred-fill background cache, a new GenreGroupingDiagram with per-genre counts, a refreshed context-menu look for cards and list rows, clearer TV Mode settings copy across languages, and adjusted TV Mode tile/layout dimensions. Also adds a full Japanese UI translation, renames 8-bit GameBoy shader uniforms for consistency, and removes debug logging from RA badge prefetch.
Highlights
- Japanese localization: A full Japanese UI translation lands as
ja.json, wired into the language picker inGeneralSettingsViewand the Xcode build. The app now ships with English, Spanish, Portuguese, and Japanese. - Live in-game shader editor sidebar: From the game window, open a sidebar to live-edit shader parameters. Unsaved edits are guarded with a confirmation overlay, and changes persist into the shader preset with SwiftUI state refreshing automatically.
- Bezel reflection blur: Bezel reflections blend
the reflected bezel into the scanline/phosphor resultof FamicomRF and RfDisplay for a more realistic CRT-on-flat-panel effect. New uniform parameters control bezel rounding, glow, and reflection blur; mask handling is more stable in the RF display. - Slang preset management & stable IDs: Presets are grouped on display, and name collisions are disambiguated by a SHA-256–derived stable preset ID. A cached
_finalPassIsAbsoluteflag drives aspect-ratio/viewport scaling without entering@MainActorcontext. Discovery errors are handled and logged. - Overscan & aspect-ratio handling: The RGBA conversion path defaults overscan to zero so the full source image remains visible;
MetalCoordinatorcaches system recognition for consistent aspect-ratio handling;XPCBridgeAdaptercaches the aspect ratio to cut synchronous XPC round trips. - Rendering performance pass: A generation-gated uniform cache in the RF decoder path avoids needless dictionary copies during gameplay;
CRTFilter.metalaligns the phosphor mask/scanlines to source pixels regardless of output upscale; audio resampling inStreamRecordingServiceusesUnsafeBufferPointer;GameTimeBarOverlayconnects its timers only when the overlay is visible; drawable alpha is reset after Slang renders to prevent transparency artifacts. - Box art display modes: A new display-mode option plus integration into
GameCardView,GridCollectionView, andLibraryGridView, backed by a blurred-fill background image cache inImageCacheso cards render with a soft tinted backdrop derived from their own cover. - Genre grouping diagram & per-genre counts: New
GenreGroupingDiagramvisualizes genre settings;GenreManagerexposes counts andGenrePickerViewshows them. New labels and descriptions in en/es/pt. - Card/list-row context menu polish:
GameCardViewandGameListRowViewget a refreshed context-menu appearance and structure. - TV Mode copy & layout: TV Mode settings descriptions are rewritten for clarity and consistency across en/es/pt, and the TV Mode game tile and view layout dimensions are adjusted for better fit.
- 8-bit GameBoy shader cleanup: Uniform variables in
8bGameBoy.metalare renamed for consistency and clarity, with matching updates inShaderPreset,MetalCoordinator, andShaderUniforms. - RA badge prefetch logging: Removed debug logging for existing badges during the prefetch pass.
Detailed Changes
- feat(shader): implement live shader editor sidebar with unsaved changes confirmation —
StandaloneGameWindowControllerhosts the sidebar; parameters apply instantly; confirmation overlay protects unsaved edits; preset handling refactored for seamless apply/persist; en/es/pt translations added - feat: implement bezel reflection blur for enhanced visual effects and optimize rich presence handling
- feat: enhance bezel reflection handling in
applyMaskAndBezelfor improved visual fidelity - feat: enhance bezel mask handling for improved visual fidelity and stability in the RF display
- feat: add support for bezel reflection in
RfDisplayandShaderUniforms— new uniform parameters: bezel rounding, glow, reflection blur - Enhance Slang Compiler and Metal Coordinator for improved rendering — cached
_finalPassIsAbsolutewithout@MainActor; aspect-ratio/viewport scaling keyed off the preset's final pass type; final-pass state logged at activation; drawable alpha handling fix prevents transparency after Slang renders;SlangPresetDiscoveryServicetracks errors and disambiguates names via SHA-256 stable IDs - Enhance shader and rendering performance — generation-gated uniform cache for the RF decoder path;
CRTFilter.metalaligns phosphor mask and scanlines to source pixels;FamicomRF.metal/RfDisplay.metalincorporate bezel reflection blur; cached aspect ratio inXPCBridgeAdapter;StreamRecordingServiceresamples audio withUnsafeBufferPointer;GameTimeBarOverlaymanages timer connections by overlay visibility;MetalCoordinatorcaches system recognition - feat: enhance Slang preset management with grouping and improved display handling
- feat: adjust overscan setting to zero for improved visual output in RGBA conversion
- feat: add box art display mode options and integrate into library views — new options on
SystemInfo;GameCardView,GridCollectionView,LibraryGridViewupdated; en/es/pt keys added - feat: implement blurred fill image caching for box art display mode —
ImageCachegrows a blurred-fill background cache;GameCardViewuses it for soft tinted card backdrops - feat: add
GenreGroupingDiagramand enhance genre grouping settings with new labels and descriptions — 315-line diagram view wired intoGenreSettingsViewandSettingsCatalog; en/es/pt labels added - feat: add genre count functionality to
GenreManagerand integrate withGenrePickerView— per-genre counts in the picker and grid view - feat: enhance context menu appearance in
GameCardViewandGameListRowView - feat: enhance TV Mode settings descriptions for clarity and consistency across languages —
TVModeMainSettingsViewrewrite; en/es/pt copy aligned - feat: adjust dimensions for TV Mode game tile and view layout —
TVModeGameTileandTVModeViewsizing pass - feat: rename shader uniform variables for consistency and clarity for 8-bit GameBoy shader —
8bGameBoy.metal,ShaderPreset,MetalCoordinator,ShaderUniformskept in sync - feat: remove debug logging for existing badges during the prefetching process —
RABadgeCacheService - feat: add full Japanese UI translation —
ja.json(2468 lines), wired into the language picker inGeneralSettingsViewand the Xcode resource build; the app now ships en/es/pt/ja - Refactor code structure for improved readability and maintainability
1.8.6
- Ajout de slots de sauvegarde renommables via un stylo en survol ou un menu contextuel, avec persistance dans un fichier .meta.json.
- Synchronisation des enregistrements vidéo/audio malgré les redémarrages de Time Machine, avec options pour couper les redémarrages ou les autoriser.
- Mode TV avec sélection de l’écran affiché via un nouveau ScreenCatalog et gestion centralisée des paramètres (thème, comportement, collections).
- Touche chaude pour basculer dynamiquement le contrôleur Wii, avec prise en charge du suivi de pointeur synthétique.
- Intégration d’une API RetroAchievements pour les sessions et pings, avec gestion des erreurs structurées et notifications de reconnexion.
- Suppression des demandes répétées de permissions Downloads via une gestion fine des scopes TCC et des logs sécurisés.
v1.8.6
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.
Highlights
- Renamable save state slots — hover to reveal an inline rename pencil, or use the Rename item in the slot/thumbnail context menu. Names persist in a sidecar
.meta.jsonnext to each.statefile and revert to "Slot N" once emptied. Auto slot (-1) is intentionally non-renamable. - Recording stays in sync across Time Machine rewinds (#30) — video frame appends and audio capture are suspended during rewind/scrub mode, and the rewind window's wall-clock duration is subtracted from PTS anchors so the recording skips the rewind on both tracks (no frozen frame, no silence gap). Opt-in "Cut rewinds from recording" and "Allow rewind during recording" settings expose both behaviors; the writer is stopped synchronously on window close to avoid an audio-capture crash on an unmapped XPC shared-memory pointer.
- TV Mode screen selection — a new
TVModeMainSettingsViewcentralizes TV Mode settings (behavior, theme, display, visible collections, gamepad remapping), andTVModeScreenPickerViewlets you choose which connected display to use when entering TV Mode via a newScreenCatalog. - Wii controller toggle hotkey — attach/detach the Wii controller at runtime. Wii IR settings use stringified integers for core options, with adjusted defaults in
dolphin_libretro_default.json; synthetic pointer tracking is supported during input capture. - RetroAchievements session/ping API — adds
rcheevos_api_init_ping,rcheevos_api_init_start_session, andrcheevos_api_init_login_with_token. The settings view surfaces a refresh action for user stats and re-login notifications. Error handling is now a structuredRAErrortype with localized messages. - TCC folder-scope management — combined with the
LogManager/LoggerServicebookmark fix (resolve with.withSecurityScope, pairstartAccessingSecurityScopedResource/stopAccessingSecurityScopedResourcearound the open log file handle), the app no longer re-prompts for Downloads access on every launch. - Hotkey settings revamp — reset individual hotkey actions or multiple at once to defaults; new
HotkeyTabenum organizes App, In-Game, and Special hotkeys with Wii controller and Speed & Rewind sections. Gamepad Navigation is reused under Hotkeys. - BoxArtService integration —
GameCardViewandGameDetailViewuse the shared service, with a newforceReplaceparameter ondownloadAndCache. - Per-launch auto-load override —
launchGamegains adisableAutoLoadOnStartparameter to skip auto-load for a single launch without changing the global preference.
1.8.5
- Correction d’une crash à l’initialisation introduite en 1.8.4, liée à une boucle de réentrée dans AppSettingsCache et LoggerService.
- Synchronisation du mécanisme de protection dispatch_once avec LoggerService.initDepth pour éviter les blocages récursifs.
- Résolution du problème de lecture/écriture concurrentes pendant loadFromSwiftData(), bloquant le cycle LocalizationManager → AppSettingsCache → SwiftDataContainer → LoggerService.
- Affichage d’un message d’erreur explicite : BUG IN CLIENT OF LIBDISPATCH: trying to lock recursively lors du démarrage.
- Correction valable pour toutes les configurations (Debug et Release) sans restriction de plateforme.
v1.8.5 — Hotfix
Hotfix release: stops the launch-time crash introduced in 1.8.4.
Highlights
- Launch crash fix:
AppSettingsCachenow mirrors the existingLoggerService.initDepthre-entrancy guard. Reads return their declared default and writes drop whileloadFromSwiftData()is running, so the cycleLocalizationManager → AppSettingsCache → SwiftDataContainer → LoggerService → LogManager → AppSettingsCachecan no longer re-enter the samedispatch_oncetoken. Affects every build configuration (Debug and Release).
The crash manifested on startup as EXC_BREAKPOINT from libdispatch with BUG IN CLIENT OF LIBDISPATCH: trying to lock recursively, traced through AppSettingsCache.loadFromSwiftData → SwiftDataContainer.shared → makePreMigrationBackup → LoggerService.info → LoggerService.shared → setupFileLogging → LogManager.shared → ensureLogDirectoryExists → AppSettings.getData → AppSettingsCache.shared.
1.8.4
- Correction majeure : le mode TV conserve désormais l’état de la dernière session après redémarrage (plus de retour forcé en mode TV).
- Ajout de présets de contrôleurs préconfigurés pour 8BitDo Ultimate 3 (mode Xbox), Lic Pro et Xbox Wireless.
- Script intégré pour exporter les configurations de manettes utilisateur vers les fichiers de présets.
- Intégration des nouveaux fichiers de présets et du gestionnaire de contrôleurs dans le projet.
v1.8.4
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.
Highlights
- TV Mode respects the last session:
TVModeSettingsManagernow readstvMode_currentlyActiveon init (the runtime-mode key it has been writing on every toggle) and only falls back to thelaunchInTVModepreference on a true first launch, so exiting TV Mode and quitting now actually persists. - Bundled controller presets: New
BundledControllerPresets.swiftloads default controller mappings from JSON at launch, with new presets for 8BitDo Ultimate 3-mode (Xbox layout), Lic Pro Controller, and Xbox Wireless Controller.ControllerServiceuses them as the default-mapping source. - Preset export utility:
scripts/export_controller_presets.pyexports user-saved controller mappings into the bundled preset JSON files.
Detailed Changes
- Read
tvMode_currentlyActiveatTVModeSettingsManagerinit and fall back tolaunchInTVModeonly when no prior session has been recorded, so cold-start TV-mode state matches the user's quit-time state - Add
BundledControllerPresets.swiftto load default controller mappings from JSON at app launch - Add new controller preset JSON files for 8BitDo Ultimate 3mode Xbox, Lic Pro Controller, and Xbox Wireless Controller
- Update
ControllerServiceto use bundled presets as the source for default mappings - Add
export_controller_presets.pyscript to export user-saved controller mappings to bundled preset files - Update
project.pbxprojto include the new source files and resources
1.8.3
- Suppression définitive des échecs silencieux lors de la suppression d’états sauvegardés via les menus contextuels et les vues dédiées.
- Suppression des notifications intempestives d’update sur les installations récentes, désormais vérifiées sans condition de débogage.
- Chargement des jeux en mode TV plus fiable grâce à une initialisation redéfinie du library et une entrée en plein écran systématique.
- Nettoyage de ~20 avertissements Swift 6 (isolation d’acteur, liaisons inutilisées, API obsolètes) dans les sources.
Patch release fixing two regressions — silent save-state deletion failures and false-positive update notifications on the current version — plus a TV-mode game-loading reliability pass and a broad Swift 6 warning cleanup.
Highlights
- Deleting save states works again: Delete handlers in
ModernSaveStateSlotViewand the progressive thumbnail context menu now build the same compositedisplayName__key the save path uses (#27). - No false update prompt on the current version: Update availability in
AppUpdateServiceis no longer gated behind#if LOG_DEBUG, so fresh installs no longer report themselves as outdated (#25). - TV Mode reliability: Library initialization was refactored so games load deterministically in TV mode, and entering TV mode now triggers a fullscreen entry pass to keep the controller focused.
- Swift 6 warning cleanup: Removed ~20 actor-isolation, unused-binding, and deprecated-API warnings across Swift sources to keep the build log actionable.
Detailed Changes
- Fix save-state delete handlers to use the composite
displayName__key (Fixes #27) - Drop
#if LOG_DEBUGgating of update availability inAppUpdateService(Fixes #25) - Refactor ROM library initialization so games are loaded in TV mode
- Add fullscreen entry logic on TV Mode activation
- Update build configurations and logging-flag documentation
- Add debug logging for time-machine operations
- Cleanup Swift 6 warnings: redundant
await, unused bindings, deprecatedonChange(of:perform:), default actor-isolation args, confusable trailing-closure bodies - Revise asset links and trim outdated sections in
README.md
1.8.2
- Mode TV : la touche Y sur la page de détail d’un jeu lance une nouvelle session sans charger automatiquement un état de sauvegarde, tandis que A charge l’état le plus récent.
- Sécurité des sauvegardes : la désactivation automatique au démarrage ne modifie plus le paramètre global saveState_autoLoadOnStart de l’utilisateur.
- Hiérarchie de navigation au gamepad : les combinaisons de touches liées à "Afficher la barre d’outils" et "Entrer en Mode TV" ne déclenchent plus les deux actions simultanément.
- Stabilité du Mode TV en plein écran : la fenêtre clé est rétablie après la fermeture de la feuille de réglages, rétablissant la réactivité du contrôleur sans clic de souris.
- Gestion des fenêtres : ajout d’un mécanisme de réaffectation du keyWindow pour éviter les blocages post-fermeture de feuille dans le Mode TV en plein écran.
v1.8.2
Patch release refining TV Mode ownership of save state slots and the gamepad navigation hierarchy between gameplay and the app.
Highlights
- TV Mode: Y on the game-detail page now launches a fresh session without auto-loading a save state, while A continues to load the most recent save (Continue).
- Save state safeguards: Per-launch auto-load override no longer overwrites the user's global
saveState_autoLoadOnStartpreference. - Gamepad navigation hierarchy: A combo bound to both "Show Game Toolbar" and "Enter TV Mode" now fires only the context-appropriate action — toolbar during gameplay, TV-mode entry in the library — enforcing a "game wins over app" priority.
- Fullscreen TV Mode reliability: Re-asserts key-window status after the in-app settings sheet dismisses so the controller stays responsive without a mouse click.
Detailed Changes
- Added per-launch
disableAutoLoadOnStartplumbing throughTVModeViewModel.launchSelected→GameLauncher.launchGame→StandaloneGameWindowController.launch - Introduced
effectiveShouldAutoLoad()onStandaloneGameWindowControllerso a fresh-start launch never clobbers the user's global auto-load preference - Routed Y on the TV Mode game-detail page to
launchSelected(disableAutoLoad: true); Y elsewhere still opens the settings sheet - Surfaced the most-recent save slot on the TV Mode detail page and bound A to Continue (load slot) when a save exists
- Softened the
GamepadNavigationManager.pollkey-window guard so global overlay contexts dispatch regardless of transiently-nilNSApp.keyWindow(fixes post-sheet-dismissal deadness in fullscreen TV Mode) - Added
GamepadNavAction.isLibraryOnlyActionand gatedprocessActionson a "game wins over app" hierarchy so a shared combo no longer double-fires toolbar + TV-mode entry - Strengthened
restoreKeyWindowAfterSettingswith a second delayed re-key attempt to cover SwiftUI sheet teardown races on fullscreen windows
1.8.1
- Ajout du support natif pour les multi-joueurs au clavier, avec une refonte des mappings simplifiée et une priorité donnée aux slots de contrôleurs vides avant le remplacement du clavier.
- Gestion améliorée des contrôleurs : désactivation et réinitialisation des contrôleurs SDL et clavier, avec une option pour remplacer l’entrée clavier par un nouveau contrôleur connecté.
- TV Mode : synchronisation des filtres et sélections ROM lors de la restauration de l’état, ajout d’un mode raccourci avec duplication fluide des éléments et d’un surcouche dédiée aux téléchargements de cœurs.
- Intégration RetroAchievements : vérification conditionnelle du pré-chargement du cache et affichage du RA Hash dans la vue détaillée des jeux.
- Améliorations macOS : gestion native du plein écran via clavier ou manette dans TV Mode, navigation améliorée avec les gamepads et mise à l’échelle adaptative à la résolution.
- Corrections dans StandaloneGameWindowController pour afficher les erreurs spécifiques des runners et conservation des filtres utilisateur lors de l’activation de TV Mode.
v1.8.1 — Patch Release
July 23, 2026
Patch release focused on controller management improvements and TV Mode refinements.
Highlights
- Multi-player keyboard mapping: Refactored keyboard input to support multiple players with simplified controller settings.
- Controller slot management: Gap-slot prioritization over keyboard replacement when connecting new controllers.
- SDL controller controls: Added disable and reset functionality for SDL and keyboard controllers.
- TV Mode enhancements: Filter sync on state restoration, reset filters action, sort mode, short-list mode with smooth item duplication, and core download overlay for seamless core management.
- TV Mode quality-of-life: Fullscreen exit via keyboard/gamepad, resolution-adaptive scaling, and improved gamepad navigation.
- RetroAchievements fixes: Cache pre-load condition check and RA Hash display in game detail view.
Detailed Changes
- Updated controller management to prioritize gap slots over keyboard replacement and adjusted default setting
- Added option to replace keyboard input with newly connected controllers
- Enhanced controller management with disable and reset functionality for SDL and keyboard controllers
- Refactored keyboard mapping to support multiple players and simplify controller settings
- Improved TV Mode fullscreen exit handling and gamepad navigation support
- Added TV Mode functionality with controller bindings and UI updates
- Enhanced TV Mode state restoration by syncing filter and ROM selections
- Added reset filters action and sort mode functionality in TV Mode
- Implemented short-list mode with smooth item duplication for TV Mode
- Enhanced RetroAchievements integration with cache pre-load condition check
- Improved error handling in StandaloneGameWindowController to surface specific runner errors
- Updated TV Mode to maintain user's filter selection when entering TV mode
- Implemented auto-fullscreen restoration in TVModeSettingsManager when exiting TV mode
- Enhanced TV Mode view to manage keyboard input more effectively during gameplay
- Added new translations for core download actions and game info in English, Spanish, and Portuguese
- Introduced TVModeCoreDownloadOverlay for better core management in TV mode
- Updated GameDetailView to display RA Hash and improved achievement loading logic
- Implemented resolution-adaptive scaling for TV Mode
- Enhanced controller settings with SDL support and live axis observation
1.8.0
- Ajout d’un mode TV avec navigation en plein écran, tuiles d’affichage des jeux, animations d’arrière-plan et vue détaillée intégrée.
- Système de box-art optimisé : chargement asynchrone des miniatures, résolution locale des chemins et thème dédié au mode TV.
- Améliorations pour RetroAchievements : activation au premier lancement, indicateur de progression pour l’import de cache et le matching des jeux.
- Fiabilité des sauvegardes et rewind : correction des problèmes de double-rewind via une refonte du polling XPC et gestion améliorée des sauvegardes PS2.
- Filtrage et recherche dans la bibliothèque : fonctionnalité type-to-search, collections intelligentes et gestion des états vides par système.
- Shaders d’arrière-plan : refonte du filtre LCD Grid, contrôle manuel du sync RF et améliorations des uniformes Famicom.
v1.8.0
Feature release focused on TV Mode, infrastructure, and quality-of-life.
Highlights
- TV Mode: Full-screen TV-style library browsing with entry tiles, animated backgrounds, an integrated game detail view, and box-art focus scaling.
- Box-art pipeline: Async thumbnail loading, local-path resolution, refined resampling, and a dedicated TV Mode boxart theme.
- RetroAchievements upgrades: First-run enable prompt (with hardcore option), cache-import and game-matching progress indicators, accurate console-ID mapping via RomHasher.
- Rewind & save-state reliability: XPC state polling and capture reworked to fix serious double-rewind issues (#20); better Play! (PS2) save-state handling.
- Library browsing: Type-to-search, search-aware smart collections, system-aware empty states, sidebar filtering, and gamepad auto-repeat.
- Background shaders: Refactored LCD Grid, manual RF sync-hold and position controls, enhanced Famicom RF uniforms.
- ROM scanning & metadata: Caching and filtering, refactored scan/identification, and merged-ROM derived-field refresh.
- Infrastructure: iCloud dataless-placeholder materialization, ROM removal notifications, improved XPC crash error handling, pause hotkey binding.
See the full changelog for details: https://juanchogithub.github.io/truchiemu/changelog/v1.8.0.html
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.