truchiEmu

Emulator 1.16.1

Frontend Libretro natif macOS (ARM)

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 Mac OS X - macOS Apple Silicon Apple Silicon

Download and links

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:

  1. Quit TruchiEmu.
  2. In Finder, move the stray blank item to Trash. Delete nothing else.
  3. Download TruchiEmu-v1.15.2.zip below.
  4. Unzip it and move TruchiEmu.app to /Applications with Replace.
  5. Launch from /Applications and 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.app by 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 through NSWorkspace.
  • Update recovery prompt: on launch the app scans /Applications for 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.

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum