Skip to content

Wishlist and Monitoring

BlizzHacker edited this page Nov 17, 2026 · 1 revision

Wishlist and Monitoring

Open Games → Add New, type a title and choose Find games. With IGDB configured under Settings → Metadata, you'll get matching games with a platform picker. Without IGDB, enter the exact title and pick the platform yourself. A disabled IGDB provider is never queried.

Save, monitor or search

  • Save to wishlist remembers the game without searching. Scheduled searches and RSS checks skip wishlist games.
  • Monitor and search now searches your sources straight away. If nothing suitable turns up, the game stays monitored and is checked again later.
  • Pause monitoring keeps the entry and its history but stops automatic searches. Resume monitoring turns them back on.

Wanted → Missing

Filter by All, Monitored or Wishlist. The monitoring button changes one game at a time. Search All only searches monitored games and leaves your wishlist alone.

Game pages

Click a game in your library or wishlist to open its page. It shows:

  • whether it's in your library, monitored, or on your wishlist;
  • active downloads and recent history for that game;
  • cached metadata, your personal status, rating and notes;
  • Open in RomM, when the game lives in a RomM library;
  • Interactive Search, pre-filled with the title and platform.

Game pages are opened per library source. If two libraries happen to use the same game id, ROMarr asks you to open the game from a specific library rather than guessing.

Download progress

Queue shows qBittorrent progress, speed and ETA when the client reports them. Missing values stay blank rather than showing zero. A qBittorrent reply of "Fails." is treated as a failed grab.

API

Endpoint Purpose
GET /api/v1/lookup?q=… Catalogue search with per-platform library and monitoring state
GET /api/v1/game/detail?platform=…&id=… One game's page data (title= instead of id= also works; source= picks a library)
POST /api/v1/wanted/add game, platform, monitored (default true), search (default false)
POST /api/v1/wanted/monitor game, platform, monitored

Full guide: MONITORING.md.

Clone this wiki locally