Overview
This is the official documentation for RomM, the beautiful, powerful self-hosted ROM manager and player. Here you'll find everything you need to know about setting up, configuring, and using RomM.
Building the documentation
We use uv to build the documentation. To install it, run:
curl -LsSf https://astral.sh/uv/install.sh | sh
Then install python and the required dependencies:
uv install python
uv sync --all-extras --dev
Finally run the following command to serve the documentation from a local server:
uv run mkdocs serve
Contributing
We welcome all types of contributions, from simple typo fixes to new content. If you'd like to contribute, please read our code of conduct.
Setting up the linter
We use Trunk for linting, which combines multiple linters with sensible defaults and a single configuration file. You'll need to install the Trunk CLI to use it.
- Install the Trunk CLI
curl https://get.trunk.io -fsSL | bash
Alternative installation methods can be found here. On commit, the linter will run automatically. To run it manually, use the following commands:
trunk fmt
trunk check
Social
Join us on Discord, where you can ask questions, submit ideas, get help, showcase your collection, and discuss RomM with other users.
