rommapp/romm

Features

• Self-Hosted Management - Provides a self-hosted server for organizing personal ROM collections with automated scanning and metadata retrieval.
• Web-Based Emulators - Executes emulator cores directly in the web browser using WebAssembly for instant game playback.
• Game Save Synchronization - Provides secure SSH-based synchronization of game saves and states between the server and handheld devices.
• Content Metadata Enrichment - Augments game entries with detailed information and custom tags for better organization.
• External Metadata Integration - Fetches game titles, descriptions, and artwork from databases like IGDB and ScreenScraper.
• Self-Hosted Game Library Managers - Provides a central server for storing, categorizing, and sharing ROMs and emulator firmware across platforms.
• Game ROM Organization - Provides a web interface for organizing ROM collections with automated scanning and metadata retrieval.
• ROM Collection Scanning - Scans local storage for ROM files and identifies games across multiple platforms.
• Game State Persistences - The project writes save actions and state captures from an active emulator session directly back to the server.
• Metadata Aggregators - Aggregates game titles, artwork, and completion times from external gaming databases and APIs.
• Save Synchronizers - Automates the synchronization of game save files and states between the server and handheld devices via SSH.
• Hash-Based Matching - Identifies game files by calculating unique signatures to ensure accurate metadata retrieval from external databases.
• Emulation Save Management - Stores and retrieves game progress and snapshots to allow users to resume play from a specific point.
• Game Save Synchronization Tools - Transfers save files and emulator states between the server and registered devices to maintain progress.
• Game Library Ingestion - Supports the upload of ROMs, firmware, and cover art to organize the game library.
• Game Progress Synchronization - Uploads save files, game states, and screenshots to track individual player progress.
• WebAssembly-Based Playback - Enables playing Flash and Shockwave content directly in the browser via WebAssembly.
• OIDC Authentication Plugins - Provides single sign-on and centralized multi-factor authentication through OpenID Connect integration.
• Role-Based Access Control - Assigns users to predefined roles with specific scopes to control library curation and user management.
• Hashing-Based Matching - Identifies games using file hashes via providers like Hasheous and Playmatch.
• Media Filename Parsers - Extracts provider IDs from filenames to precisely match games with external metadata entries.
• Web Library Browsers - Provides a responsive web interface to view and navigate a self-hosted collection of ROMs.
• Game Asset Management - Stores and organizes user-uploaded save files, emulator states, and screenshots.
• System Firmware Importers - Manages the upload and storage of BIOS files to provide necessary firmware for emulation cores.
• Category Organizations - Allows users to create named groupings of ROMs into custom categories.
• Library Data Feeds - Offers formatted library data feeds for consumption by third-party tools and bootloaders.
• Dynamic Collections - Creates virtual game collections that update automatically based on metadata filters.
• Library Scan Scheduling - Runs recurring background jobs for file scanning, metadata synchronization, and asset optimization.
• Metadata-Based Grouping - Provides automatic grouping of games into collections based on shared attributes such as genre, developer, or franchise.
• Remote Library Synchronization - Allows external launchers and handheld companions to browse and launch games from the remote server.
• System Firmware Storage - Tracks and stores BIOS or firmware files per platform and serves them to web players and companion apps.
• Data Integrity Verification - Calculates and validates CRC, MD5, and SHA1 hashes for game files to detect corruption.
• Game State Persistence - Captures the real-time memory state of running games to allow players to resume from specific points.
• REST APIs - Provides a documented REST API for programmatically accessing game data and management functions.
• Achievement Tracking Integrations - Integrates with RetroAchievements to track and display game milestones for users.
• Session Configuration - Configures Netplay and STUN/TURN servers through the web interface to facilitate multiplayer gaming sessions.
• Playback Orchestration - Orchestrates game playback by launching in-browser emulators or prompting downloads for unsupported platforms.
• Retro Gaming Social Infrastructure - Hosts multiplayer netplay sessions and tracks community achievements for classic games through a web interface.
• Emulated Input Mappings - Provides global and per-core emulator settings and input mappings for keyboards and controllers.
• Game File Streaming - Streams ROMs and multi-disc game sets directly from disk to the client as zip archives.
• Homebrew Game Feeds - Provides specialized URL endpoints for homebrew installers on consoles to discover and install games.
• Multiplayer Game Servers - Connects multiple players over the internet via WebSockets and NAT traversal for real-time co-op or competitive play.
• Remote ROM Streaming - Provides direct HTTP URLs for game files to enable remote loading of ROMs into emulator software over Wi-Fi.
• Scoped Token Issuance - Generates long-lived, scoped API tokens for companion apps and secure handheld device pairing.
• Companion Device Registration - Enables linking handheld devices to the server for managing game save synchronization paths.
• Identity Provider Role Mapping - Maps user roles and permissions based on groups or claims provided by an external identity provider.
• OIDC Identity Integrations - Implements single sign-on and centralized authentication using OpenID Connect.
• OpenID Connect Support - Provides an identity system leveraging OIDC for single sign-on and role-based access control.
• Passkey Authentication - Allows users to sign in using passwordless passkey authentication via external identity providers.
• Single Sign-On Integrations - Integrates with external identity providers via OpenID Connect for single sign-on and role mapping.
• External Provider Redirections - Redirects users directly to external identity providers for a seamless single sign-on experience.
• Game File Standardization - Standardizes ROM file paths and names to ensure compatibility with library managers.
• Redis-Backed Queues - Uses a Redis-backed queue to process asynchronous library scans and image conversions.
• Job Queues - Uses a Redis-backed queue to process long-running operations and asynchronous jobs in the background.
• Background Task Schedulers - Executes scheduled and manual background tasks like library rescans and image conversion.
• Game Binary Patching - Modifies game files using various patch formats directly in the browser to apply translations or fixes.
• Filesystem Change Monitors - Monitors library folders for file events to automatically trigger game scans.
• Gamepad-Driven Navigation - Provides a spatial grid-based interface designed for TVs and controllers using gamepad polling.
• Gamepad-Optimized Interfaces - Provides a dedicated interface optimized for gamepads and TV displays.
• Multiplayer Session Synchronizers - Utilizes WebSockets to provide live-update channels and synchronization for real-time networked multiplayer sessions.
• Gaming Tools - Listed in the “Gaming Tools” section of the Awesome Selfhosted awesome list.

Star history