# GitHub - rommapp/romm: A beautiful, powerful, self-hosted rom manager and player.

[![romm logo](https://github.com/rommapp/romm/raw/master/.github/resources/isotipo.png)](https://github.com/rommapp/romm/blob/master/.github/resources/isotipo.png)

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

[](#----a-beautiful-powerful-self-hosted-rom-manager-and-player--)

## Overview

[](#overview)

RomM (ROM Manager) allows you to scan, enrich, browse and play your game collection with a clean and responsive interface. With support for multiple platforms, various naming schemes, and custom tags, RomM is a must-have for anyone who plays on emulators.

## Features

[](#features)

- Scan and enhance your game library with metadata from [IGDB](https://docs.romm.app/latest/Getting-Started/Metadata-Providers/#igdb), [Screenscraper](https://docs.romm.app/latest/Getting-Started/Metadata-Providers/#screenscraper) and [MobyGames](https://docs.romm.app/latest/Getting-Started/Metadata-Providers/#mobygames)
- Fetch custom artwork from [SteamGridDB](https://docs.romm.app/latest/Getting-Started/Metadata-Providers/#steamgriddb)
- Display your achievements from [Retroachievements](https://docs.romm.app/latest/Getting-Started/Metadata-Providers/#retroachievements)
- Metadata available for [400+ platforms](https://docs.romm.app/latest/Platforms-and-Players/Supported-Platforms/)
- Play games directly from the browser using [EmulatorJS](https://docs.romm.app/latest/Platforms-and-Players/EmulatorJS-Player/) and [RuffleRS](https://docs.romm.app/latest/Platforms-and-Players/RuffleRS-Player/)
- Share your library with friends with limited access and permissions
- Official apps for [Playnite](https://github.com/rommapp/playnite-plugin), [Android](https://github.com/rommapp/argosy-launcher) and [CFWs](https://github.com/rommapp/grout)
- Supports multi-disk games, DLCs, mods, hacks, patches, and manuals
- Parse and filter by [tags](https://docs.romm.app/latest/Getting-Started/Folder-Structure/#tag-support) in filenames
- View, upload, update, and delete games from any modern web browser

## Preview

[](#preview)

🖥 Desktop 📱 Mobile [![desktop preview](https://github.com/rommapp/romm/raw/master/.github/resources/screenshots/preview-desktop.webp)](https://github.com/rommapp/romm/blob/master/.github/resources/screenshots/preview-desktop.webp) [![mobile preview](https://github.com/rommapp/romm/raw/master/.github/resources/screenshots/preview-mobile.webp)](https://github.com/rommapp/romm/blob/master/.github/resources/screenshots/preview-mobile.webp)

## Installation

[](#installation)

To start using RomM, check out the [Quick Start Guide](https://docs.romm.app/latest/Getting-Started/Quick-Start-Guide/) in the docs. If you are having issues with RomM, please review the page for [troubleshooting steps](https://docs.romm.app/latest/Troubleshooting/Scanning-Issues/).

## Contributing

[](#contributing)

To contribute to RomM, please check [Contribution Guide](https://github.com/rommapp/romm/blob/master/CONTRIBUTING.md).

## Official apps

[](#official-apps)

Apps and integrations built and maintained by the RomM team.

- [Argosy](https://github.com/rommapp/argosy-launcher) by [@tmgast](https://github.com/tmgast): Native Android client for installing and launching games.
- [Grout](https://github.com/rommapp/grout) by [@BrandonKowalski](https://github.com/BrandonKowalski): Download and manage games from your RomM instance directly on your Linux based retro handheld. Supports: Allium, Batocera, Knulli, MinUI, muOS, NextUI, Onion, ROCKNIX, Spruce, TrimUI
- [Playnite plugin](https://github.com/rommapp/playnite-plugin) by [@gantoine](https://github.com/gantoine): Library plugin for Playnite

## Community

[](#community)

Here are a few projects maintained by members of our community. Please note that the RomM team does not regularly review their source code.

### Mobile

[](#mobile)

- [romm-ios-app](https://github.com/ilyas-hallak/romm-ios-app): Native iOS app by [@ilyas-hallak](https://github.com/ilyas-hallak)

### Desktop

[](#desktop)

- [RetroArch Sync](https://github.com/Covin90/romm-retroarch-sync): Sync RetroArch library with RomM by [@Covin90](https://github.com/Covin90)
- [RomMate](https://github.com/brenoprata10/rommate): Desktop app for browsing your collection by [@brenoprata10](https://github.com/brenoprata10)
- [romm-client](https://github.com/chaun14/romm-client): Desktop client by [@chaun14](https://github.com/chaun14)
- [Freegosy](https://github.com/abduznik/freegosy): All-in-one game manager (download, launch, sync saves, and manage emulators) by [@abduznik](https://github.com/abduznik)

### Handhelds

[](#handhelds)

- [DeckyRommSync](https://github.com/danielcopper/decky-romm-sync): SteamOS downloader and syncer by [@danielcopper](https://github.com/danielcopper)
- [SwitchRomM](https://github.com/Shalasere/SwitchRomM): Homebrew NRO for Switch by [@Shalasere](https://github.com/Shalasere)

### Other

[](#other)

- [romm-comm](https://github.com/idio-sync/romm-comm): Discord bot by [@idio-sync](https://github.com/idio-sync)
- [GGRequestz](https://github.com/XTREEMMAK/ggrequestz): Game discovery and request tool by [@XTREEMMAK](https://github.com/XTREEMMAK)
- [Syncthing sync](https://github.com/amn-96/romm_syncthing_sync): Small tool to push a Syncthing library to RomM by [@amn-96](https://github.com/amn-96)

Join us on Discord, where you can ask questions, submit ideas, get help, showcase your collection, and discuss RomM with other users.

[![discord-invite-img](https://camo.githubusercontent.com/9c38b6d7aa562bb5680d9d1bea3d24bb35b3eca9378c2e11cbdefc1097bc8b1f/68747470733a2f2f696e7669646765742e737769746368626c6164652e78797a2f50354874486e68554448)](https://discord.gg/P5HtHnhUDH)

## Technical Support

[](#technical-support)

If you have any issues with RomM, please [open an issue](https://github.com/rommapp/romm/issues/new) in this repository.

## Financial Support

[](#financial-support)

Consider supporting the development of this project on Open Collective. All funds will be used to cover the costs of hosting, development, and maintenance of RomM.

[![oc-donate-img](https://camo.githubusercontent.com/8ad87759380a5e9b7a7b463038bea3cb59bf5fe957e6c9bcfef0c65bd6bdb364/68747470733a2f2f6f70656e636f6c6c6563746976652e636f6d2f726f6d6d2f646f6e6174652f627574746f6e2e706e673f636f6c6f723d626c7565)](https://opencollective.com/romm)

## Our Friends

[](#our-friends)

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

- [EmulatorJS](https://emulatorjs.org/): An embeddable, browser-based emulator
- [RetroDECK](https://retrodeck.net/): Retro gaming on SteamOS and Linux
- [ES-DE Frontend](https://es-de.org/): Emulator frontend for Linux, macOS and Windows
- [Gaseous](https://github.com/gaseous-project/gaseous-server): Another ROM manager with web-based emulator
- [Retrom](https://github.com/JMBeresford/retrom): A centralized game library/collection management service
- [Drop](https://droposs.org/): Steam-like experience for DRM-free games
- [LanCommander](https://lancommander.app/): Digital game platform for PC games
- [Steam ROM Manager](https://steamgriddb.github.io/steam-rom-manager/): An app for managing ROMs in Steam