Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/rommapp/romm/llms.txt

Use this file to discover all available pages before exploring further.

The RomM community has built a rich ecosystem of apps, plugins, and integrations that extend what you can do with your library. From native mobile clients and desktop launchers to CFW download tools and Discord bots, there is likely already a project that fits your workflow. Apps marked with πŸ”· are officially maintained by the RomM organization.
Community projects are maintained by their respective authors and are not regularly reviewed by the RomM core team. Always check the project’s repository for setup instructions, compatibility notes, and any known issues before use.

Official Apps

πŸ”· Argosy (Android)

Native Android client by @tmgast. Browse your RomM library, download ROMs, and launch them directly into your preferred emulator from your Android device.

πŸ”· Playnite Plugin

Library plugin for Playnite by @gantoine. Imports your RomM collection into Playnite so you can manage and launch games from the Playnite interface alongside your other libraries.

πŸ”· Grout

Download client for muOS and NextUI custom firmware by @BrandonKowalski. Browse and download ROMs directly on compatible handheld devices running muOS or NextUI CFW.

Mobile

romm-ios-app

Native iOS app by @ilyas-hallak. Browse your RomM library and download ROMs from an iPhone or iPad.

romm-mobile

Cross-platform mobile app (Android and soon iOS) by @mattsays. Built with Flutter, it provides a clean interface for browsing and downloading from your library.

Desktop

RommBrowser

Electron-based desktop client by @smurflabs. Wraps the RomM web interface in a native desktop window with additional OS integration features.

RetroArch Sync

Sync your RetroArch library with RomM by @Covin90. Keeps your RetroArch playlists in sync with your RomM collection.

RomMate

Desktop app for browsing your collection by @brenoprata10. Provides a polished native interface for exploring and managing your RomM library.

romm-client

Desktop client by @chaun14. A lightweight client application for interacting with your RomM instance from a desktop environment.

Handhelds

DeckRommSync

SteamOS downloader and syncer by @PeriBluGaming. Designed for Steam Deck users running SteamOS β€” browse and download ROMs from your RomM library directly onto the device.

SwitchRomM

Homebrew NRO for Nintendo Switch by @Shalasere. Browse and download ROM files from your RomM library directly on a homebrewed Switch console.

Other Integrations

romm-comm

Discord bot by @idio-sync. Interact with your RomM library from Discord β€” search for ROMs, check library stats, and more.

GGRequestz

Game discovery and request tool by @XTREEMMAK. Lets users submit game requests and tracks which titles are missing from your library.

Syncthing Sync

Push a Syncthing-managed library to RomM by @amn-96. Automates syncing files managed by Syncthing into your RomM library folder.

Connecting to the RomM API

All third-party apps communicate with RomM through its REST API. The API is fully documented and available at /api/docs (Swagger UI) or /api/redoc on your RomM instance.

Authentication

Most apps authenticate using one of the following methods:
  • Username and password β€” standard OAuth2 password flow, returns a short-lived access token and a refresh token
  • Client tokens β€” long-lived API tokens scoped to specific permissions, generated in Settings β†’ API Tokens
For apps that need persistent access without storing your password, create a dedicated client token with only the scopes required by the app (typically roms.read and platforms.read).
See the Authentication guide for details on generating client tokens and managing scopes.

Finding the API docs

Open http://<your-romm-host>/api/docs in a browser to see all available endpoints, request/response schemas, and an interactive testing interface.

Build docs developers (and LLMs) love