Skip to content

Roadmap

Milestone 0: Repo And Integration Skeleton

  • TypeScript workspace.
  • Fastify API.
  • React dashboard.
  • Prowlarr API client.
  • Prowlarr status, indexers, categories, and search endpoints.
  • Source-neutral indexer settings for Prowlarr, Torznab, Newznab, and RSS. Done.

Milestone 1: Persistent Library

  • SQLite storage. Done.
  • Root folder CRUD and scanning. Done.
  • Steam manifest discovery. Done.
  • Game aliases and monitor state. Done.
  • Search history persistence. Done.

Milestone 2: Release Matching

  • Match releases to watched games. Done.
  • Accept/reject explanations. Done.
  • Manual search UI. Done.
  • Patch channel and platform profiles. Done.
  • Release profiles with preferred and ignored terms. Done.
  • Candidate scoring and ordering. Done.
  • Smart release classifier for patch, hotfix, DLC, mod, DRM-free, repack, platform, channel, and trust signals. Done.
  • Patch grouping API for Sonarr-style game detail pages. Done.
  • Release filters for patches, DLC, mods, DRM-free builds, newer-than-installed, repacks, untrusted releases, hide-unversioned defaults, and grab-blocked crack/DRM-bypass handling. Done.
  • Flagged release filter with search-visible, grab-blocked DRM-bypass indicators. Done.
  • Sonarr/Radarr-style game detail UI with "Patches" rows replacing seasons. Done.
  • Compatibility watcher for official/store/RSS/custom JSON update signals. Initial done.

Milestone 3: Queue And Fetching

  • Download client integration strategy. Done.
  • qBittorrent client configuration and test path. Done.
  • Transmission RPC download client support. Done.
  • Deluge Web JSON-RPC download client support. Done.
  • rTorrent XML-RPC download client support. Done.
  • Aria2 JSON-RPC download client support. Done.
  • uTorrent WebUI download client support. Done.
  • Hadouken JSON-RPC download client support. Done.
  • Vuze Transmission RPC compatibility support. Done.
  • Flood HTTP API download client support. Done.
  • Freebox Download API support. Done.
  • Synology Download Station download client support. Done.
  • SABnzbd Usenet download client support and protocol-aware handoff. Done.
  • NZBGet Usenet download client support. Done.
  • NZBVortex Usenet download client support. Done.
  • Pneumatic Usenet STRM handoff support. Done.
  • Torrent Blackhole download client handoff. Done.
  • Usenet Blackhole download client handoff. Done.
  • qBittorrent WebUI/Web API status and Gadarr-category torrent listing. Done.
  • Queue state machine. Done.
  • Queue refresh command that reconciles protocol-aware download-client progress into Gadarr queue state. Done.
  • Failed fetch blocklist handling. Done.
  • Wanted missing and cutoff-unmet views. Done.
  • Background command/task surface. Done.
  • Patch-row search handoff to enabled indexer sources. Done.
  • RSS sync command that stores candidates and auto-grabs accepted monitored releases. Done.
  • Hash/signature verification. Checksums, minimum-size import validation, trusted checksum gates, and signed Ed25519 manifest gates done.
  • Staging folder management. Dry-run import queue, manual review, manual reject, and manual apply done.
  • Queue retry, manual ready/failed, and queue blocklist actions. Done.
  • Failed-download replacement handoff to the active download client. Done.
  • Sonarr/Radarr-style manual import and filesystem browsing APIs. Done.
  • Sonarr/Radarr-style aggregated history APIs for searches, grabs, imports, failures, commands, and blocklist items. Done.

Milestone 4: Patch Apply Handoff

  • Explicit patch apply policy. Initial import policy controls done.
  • Dry-run mode. Done.
  • Backup/rollback hooks where practical. Target backup, restore-on-failed-import, and applied-import rollback actions done.
  • Platform-specific launcher integration only after safety boundaries are clear.

Milestone 5: Arr Ecosystem Depth

  • Prowlarr category selection UI. Done for saved sources using categories discovered from Prowlarr.
  • Indexer status and stats dashboard. Initial Prowlarr status/stats visibility done.
  • Prowlarr indexer sync. Done: game-category Prowlarr indexers can be imported as saved Gadarr Torznab/Newznab proxy sources.
  • RSS-compatible Sonarr named indexers. Fanzub, IP Torrents, Nyaa, and TorrentLeech source kinds and Servarr schemas done.
  • API-backed Sonarr named indexers. BroadcastheNet, FileList, and HDBits source kinds, Servarr schemas, and JSON request parsers done.
  • Notification hooks. Event-triggered Connect provider model/UI, provider delivery tests, per-trigger templates, Custom Script execution, and webhook/Discord/Slack/Gotify/Apprise/Telegram/Pushover/Ntfy/Pushbullet/Email/SendGrid/Notifiarr/Join/Mailgun/Prowl/Pushcut/Signal/Simplepush/Synology Indexer/Trakt/Twitter/Plex/Emby/Jellyfin/Kodi delivery done.
  • API key management UI. Done.
  • Optional upstream Prowlarr application adapter research.
  • Source priority conflict resolution and per-source failure backoff. Initial priority ordering and background-search backoff done.
  • Newznab/Torznab capability discovery and category pickers. Initial native and Servarr action support done.
  • Sonarr/Radarr-style quality profile, custom format, and delay profile v3 API surfaces. Done.
  • Import lists/watchlists for stores and game libraries. Steam Library, Steam Owned Games via the Servarr-compatible provider, Steam Wishlist, GOG Library, GOG Owned Games via the Servarr-compatible provider, Epic Library, Epic Owned Games via the Servarr-compatible provider, Legendary/Heroic Cache via the Servarr-compatible provider, Itch.io Library via local receipt manifests, Lutris Library via local pga.db, Amazon Games Library via local GameInstallInfo.sqlite, EA App Library via local installerdata.xml and .mfst manifests, Ubisoft Connect Library via local registry/cache records, Battle.net Library via local registry/product cache records, manual URL, custom JSON, RSS, Radarr-style TMDb List, TMDb Popular, and TMDb User providers, provider-backed test/sync, provider ID preservation, exclusions, tags, cleanup modes, and search-on-add done; additional launcher account/cache sync remains ongoing.
  • Release-calendar style view for known patch versions. Day/week/month/list preference, event filters, Servarr-style calendar/feed APIs, compatibility events, and protected iCal feed done.
  • Compatibility source sync and manual update signal review. Initial done.
  • PCGamingWiki metadata adapter. Cargo API refresh for cover art, release date, developers, publishers, genres, and external IDs done.
  • SteamGridDB artwork adapter. Bearer-token lookup plus grid/hero artwork refresh done.
  • IGDB metadata adapter. Client-ID/access-token game refresh for covers, screenshots, release dates, descriptions, genres, developers, publishers, and external IDs done.
  • Metadata screenshots and trailers. Persisted screenshot/trailer arrays, Steam and IGDB media mapping, custom JSON media fields, Servarr image exposure, and detail UI preview strip done.

Milestone 6: Deployment And Operations

  • Docker image with API and built web UI in one runtime. Done.
  • Compose file with /config, /games, and /downloads volumes. Done.
  • Docker UID/GID deployment notes for Linux and Compose-capable hosts. Done.
  • Published-image compose/env path for constrained-host testing. Done.
  • Deployment Doctor API and System status UI. Done.
  • Protected calendar feed token for shared-network exposure. Done.
  • Static UI serving from the API process. Done.
  • Opt-in API-key protection for self-hosted deployments. Done.
  • Settings UI for import lists, connect, metadata, tags, general and UI preferences. Initial done.
  • Backup list/create/delete API and UI action. Initial done.
  • Staged backup restore on restart, including Sonarr-style uploaded restore staging. Initial done.
  • Redacted log surface. Initial done.
  • GHCR multi-arch image publishing workflow. Initial done.
  • Reverse-proxy/base-url support. Static UI, API, feed, artwork, and browser session routes are mounted under GADARR_BASE_URL.
  • Backup retention settings. Done.
  • Documentation agent for README/docs/screenshot publication. Runnable scripts/documentation-agent.mjs, runbook, source-claim checks, README screenshot embed checks, parity checks, optional GitHub/live-deploy publish-state checks, and refreshed screenshot set done.
  • In-app Knowledge Base page. /knowledge-base route, sidebar navigation, workflow cards, operational runbooks, and repository-doc links done.

Removed Scope

  • Game-server management is not part of Gadarr.
  • No game-server provider model.
  • No server launch recipes, public server lists, port/firewall helpers, or remote console support.