danisiber/rom-cli

选用指南

AI 根据 README 整理 · 2026/10/22 22:36:36

使用方式

通过命令行使用，支持交互式界面和多种参数，如指定平台、搜索、下载、列出等。

查看 README 依据

## Installation ```bash git clone https://github.com/danisiber/rom-cli.git cd rom-cli ./install.sh ``` This creates a venv in `~/.venvs/rom`, installs `textual`, and publishes `rom` (and `rom-remote`) into `~/bin`. Use `PREFIX=/usr/local ./install.sh` for a different destination. ## Usage ```bash rom # opens the platform picker and browses rom -p switch # opens straight into the Switch catalog rom -p switchports # only the Switch ports/homebrew rom "metroid" # searches every source

rom -y -p gba "pokemon" # downloads the best match without asking rom --list "metroid" # lists only, does not download rom --print-url -p switch … # prints the direct link (aria2/curl) rom -l # lists the platforms rom --index # builds/prints the catalog index rom --refresh # rebuilds the index (ignores the cache) ``` With no query, `rom` opens the **platform picker**; once you pick one, it lists that platform's whole catalog (pages of 300, `n`/`b` to move) — so you can

部署要求

需要 Python 3.8+，macOS 或 Linux，安装脚本会创建虚拟环境并安装 textual。

查看 README 依据

# rom Python CLI to find and download ROMs, ISOs and Switch games from the terminal. It has an interactive UI (Textual) like `epub-search`, name search, downloads with a progress bar, and a folder organised by platform. > English-language version of the original Portuguese project by > [sostenesapollo](https://github.com/sostenesapollo/rom-cli). Thanks to the > original author for the base work — this fork translates the interface and > docs to English and tracks the upstream fixes. ## Requirements - Python 3.8+ - macOS or Linux - `textual` (`install.sh` installs it into its own venv)

已知限制

作者提醒仅使用你有权使用的内容。

查看 README 依据

Mac's network blocks the download hosts. ```bash rom-remote -p switch "mario kart" # opens the UI on the worker rom-remote -y -p snes "metroid" # downloads there and syncs back here ``` Tune it with `ROM_REMOTE_HOST`, `ROM_REMOTE_DIR` and `ROM_DIR`. ## Notice Only use what you have the right to.