GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - rommapp/romm: A beautiful, powerful, self-hosted ROM manager and player.

BranchesTags
Open more actions menu

Latest commit

 

History

14,005 Commits
14,005 Commits

Folders and files

NameName
Last commit message
Last commit date
.claude
.claude
 
 
.devcontainer
.devcontainer
 
 
.github
.github
 
 
.trunk
.trunk
 
 
.vscode
.vscode
 
 
backend
backend
 
 
docker
docker
 
 
docs
docs
 
 
examples
examples
 
 
frontend
frontend
 
 
scripts
scripts
 
 
.dockerignore
.dockerignore
 
 
.gitattributes
.gitattributes
 
 
.gitignore
.gitignore
 
 
.pinact.yaml
.pinact.yaml
 
 
.python-version
.python-version
 
 
AGENTS.md
AGENTS.md
 
 
CODE_OF_CONDUCT.md
CODE_OF_CONDUCT.md
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
DEVELOPER_SETUP.md
DEVELOPER_SETUP.md
 
 
Dockerfile
Dockerfile
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
SECURITY.md
SECURITY.md
 
 
docker-compose.oidc.yml
docker-compose.oidc.yml
 
 
docker-compose.streaming.yml
docker-compose.streaming.yml
 
 
docker-compose.yml
docker-compose.yml
 
 
entrypoint.sh
entrypoint.sh
 
 
env.template
env.template
 
 
pyproject.toml
pyproject.toml
 
 
renovate.json
renovate.json
 
 
uv.lock
uv.lock
 
 

Repository files navigation

romm logo

A beautiful, powerful, self-hosted ROM manager and player.

Trendshift hackernews badge
selfh.st badge Discord

Overview

Scan, enrich, browse and play your ROM collection from one beautiful & free self-hosted app. Metadata from 10+ providers, save sync across your devices, and support for over 400 platforms. RomM is a must-have for anyone who plays on emulators.

Browsing a library and playing a game in RomM

Features

  • Play in your browser with EmulatorJS and RuffleRS, no setup required
  • Keep saves and states in sync across your devices, with conflict resolution
  • Scan and enrich your library with metadata from IGDB, Screenscraper, LaunchBox and MobyGames
  • Fetch custom artwork from SteamGridDB and track your achievements from Retroachievements
  • Metadata available for 400+ platforms, plus multi-disk games, DLCs, mods, hacks and manuals
  • Apply romhacks and translations on the fly with the built-in ROM patcher
  • Share your library with granular per-user permissions and OIDC single sign-on
  • Official apps for Playnite, Android and CFWs
  • Free forever: AGPL-3.0, no tracking, no paid features, and total control of your data

Installation

The easiest way to start is with the Quick Start Guide in the docs. If you're having trouble with setup, please review the page for troubleshooting steps.

Prefer a hosted deploy over wiring up the stack yourself?

Deploy on Hostinger
Starting at $6.49/mo · Setup guide
Deploy on CoreHost
Starting at $2.30/mo · Setup guide

Deployment and infrastructure support for these installs is handled by Hostinger and CoreHost. Prices are indicative and may not reflect current offerings. Both send a share of the revenue back to us, which helps fund the project.

Official apps

Playnite libraryPlaynite logo Playnite plugin

Effortlessly integrate your retro game collection into Playnite, the open-source game library manager that provides a unified interface for all of your games on PC.

Windows Desktop QR pairing

Install  by @gantoine


Argosy libraryArgosy logo Argosy

Sync your library, download games on demand and track your achievements, from a gamepad-first interface designed for Anbernic, Retroid Pocket, Odin, and similar devices.

Android Handhelds QR pairing Save sync

Download  by @tmgast


Grout multi-selectGrout logo Grout

A lightweight client for your favorite handheld custom firmwares*. Download games, box art and BIOS files wirelessly, and sync your saves automatically as you play.

Linux Handhelds Save sync

Quick start  by @BrandonKowalski

*Supports Allium, Batocera, Knulli, MinUI, muOS, NextUI, Onion, ROCKNIX, Spruce and TrimUI.

Community

Here are some cool projects maintained by members of our community. Please note that our team does not regularly review their source code.

Mobile and TV

  • R-Shop: Controller-first game manager for Android handhelds and TVs by @AverageConsumer
  • romm-ios-app: Native iOS app by @ilyas-hallak
  • RomMMobile: Android app that downloads games into your existing frontend's folders by @pippopapera
  • RomMulus: Android TV app with built-in emulator cores and save sync by @DEV-DUFORD

Desktop

  • Freegosy: Cross-platform game manager with save sync by @abduznik
  • RetroVault: Native macOS library and player by @kennethreitz
  • romm-client: Desktop client by @chaun14
  • RomMate: Desktop app for browsing your collection by @brenoprata10
  • RomP: Desktop player for Windows, macOS and Linux that runs each game in its own sandbox by @RompEmu

Handhelds and Steam Deck

  • Gameflow Deck: Controller-first frontend for handhelds by @simeonradivoev
  • KONSORU: Home screen launcher for the AYN Thor with a themed UI per console by @FabianZettl
  • RomMix: Big Picture-style frontend for Linux and Steam Deck by @leclercb
  • Tender: Decky Loader plugin with library and save sync for Steam Deck by @danielcopper
  • Vita RomM: PS Vita homebrew client for browsing and downloading games by @denkacn

Consoles

  • RommPS: Client for jailbroken PS5s with game downloads and save sync by @s0liton

Sync

  • RetroArch Sync: Sync RetroArch library with RomM by @Covin90

Integrations

  • GGRequestz: Game discovery and request tool by @XTREEMMAK
  • romm-comm: Discord bot by @idio-sync

Support the project

Consider supporting this project on Open Collective. Funds cover hosting, development, and maintenance, and we pass some along to community projects to nurture a healthy ecosystem of apps.

Open Collective

Corporate Sponsors

These companies support us by providing their tools for free:

Greptile Socket

Our Friends

Here are a few projects that we think you might like:

  • Lutris: Open gaming platform for Linux
  • Cocoon: Controller-first Android frontend for retro handhelds
  • muOS: Custom firmware for Anbernic and other handhelds
  • RetroDECK: Retro gaming on SteamOS and Linux
  • Steam ROM Manager: An app for managing ROMs in Steam
  • Hasheous: Hash lookup service that maps ROMs to game metadata
  • Gaseous: Another ROM manager with web-based emulator
  • Playmatch: Microservice for matching ROM hashes to games
  • EmulatorJS: An embeddable, browser-based emulator
  • PortMaster: Native game ports for Linux handhelds
  • MelonLoader: Universal mod loader for Unity games
  • NextUI: MinUI-based custom firmware for TrimUI handhelds
  • RetroAchievements: Achievements for retro games

About

A beautiful, powerful, self-hosted ROM manager and player.

romm.app

Topics

emulationopen-sourceretrogamingrommappself-hosted

Resources

Readme
AGPL-3.0 license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

14.3k stars

Watchers

54 watching

Forks

817 forks
Report repository

Releases

Sponsor this project

Packages

Used by

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.