Library Management
TruchiEmu's intelligent library management system automatically organizes your game collection with metadata scraping, artwork downloading, and advanced filtering capabilities. Transform your ROM collection into a beautiful, searchable library with rich game information and box art.
Service Overview
The Library Management service provides comprehensive organization and discovery tools for your game collection. Using machine learning-based metadata matching and integration with multiple game databases, TruchiEmu automatically identifies games, downloads high-quality artwork, and creates an immersive browsing experience that rivals modern game launchers.
Library data flow from ROM scanning to metadata enrichment and UI display
Core Features
- Automatic Game Detection: AI-powered ROM identification using multiple database sources
- Metadata Scraping: Pulls game info, descriptions, release dates, and developer information
- Artwork Management: Automatic download of box art, screenshots, and fan art
- System Categorization: Groups games by original console/system
- Achievement Detection: Identifies games with RetroAchievements support
Technical Architecture
The library system comprises several integrated components:
- ROM Scanner: Recursive directory scanning with file hash calculation and header extraction
- Metadata Engine: Multi-source data aggregation from LaunchBox, IGDB, and custom databases
- Artwork Pipeline: Parallel downloading with format optimization and caching
- SwiftData Backend: Persistent storage with fast search and filtering capabilities
- Index Service: Full-text search across titles, descriptions, and metadata tags
Step-by-Step Configuration Guide
Initial Library Setup
-
Add ROM Directories
Navigate to
Settings → Library → ROM Directoriesand click "Add Directory". Select folders containing your game ROMs. TruchiEmu supports recursive scanning of subdirectories.
-
Initial Scan Configuration
Configure scan options: file extensions to include (nes, smc, gb, gba, etc.), exclude patterns for beta/prototype versions, and maximum file size limits for known bad dumps.
-
Start Library Scan
Click "Scan for New ROMs" in the main Library view. The scanner will calculate hashes, identify games, and fetch metadata. Progress is shown in real-time with estimated completion time.