v0.5 First public version!

April 13, 2026 251 commits (since initial)

Initial public release of TruchiEmu a native macOS retro gaming emulator built with SwiftUI and Metal, featuring a comprehensive library management system, advanced shader engine, and wide system support.

Highlights

Core Architecture

  • Native macOS application with SwiftUI interface
  • Advanced Metal-based shader engine with real-time parameter adjustment
  • Multi-system core management with automatic core detection and downloading
  • Comprehensive Libretro bridge with system-specific runners

Supported Systems

  • NES, SNES, Nintendo 64, Game Boy/Color, Game Boy Advance, Nintendo DS
  • PlayStation, PlayStation Portable, PlayStation 2
  • Sega Genesis, Sega Saturn, Sega Dreamcast, Sega 32X, Sega CD, Game Gear, Master System
  • Atari Jaguar, Atari 2600/5200/7800, Lynx
  • DOS (via DOSBox), ScummVM
  • And many more through dynamic core-to-system mapping

Feature Highlights

  • Automated library management with metadata syncing and box art downloads
  • Guided onboarding setup wizard
  • RetroAchievements integration with real-time tracking
  • Advanced input configuration with controller support (up to 4 players)
  • Slot-based save state management with compression
  • Cheat system with download and management services
  • Bezel support for enhanced visual presentation
  • CLI support for headless operation and direct ROM launching
  • Playtime tracking per game
  • Comprehensive logging system with file output
  • Game categories management
  • LCD Grid and CRT shader presets
  • First-run setup wizard for onboarding flow

Technical Highlights

  • Hardware rendering with real FBO support
  • ROM identification via CRC32 checksums and weighted scoring
  • SwiftData persistence with AppSettings migration
  • LaunchBox GamesDB integration for metadata
  • SQLite-backed storage for data persistence
  • Concurrent image caching with cost-based eviction