Questarr

Snapetech QuestarrNG fork

This fork adds the SeerrNG catalog and acquisition contract. Use ghcr.io/snapetech/questarrng:latest or the Compose file in this repository; the upstream Questarr image does not contain the SeerrNG integration routes. The fork image is published for linux/amd64 from main.

A video game management application inspired by the -Arr apps (Sonarr, Radarr, Prowlarr...) and GamezServer. Track and organize your video game collection with automated discovery and download management.

⭐ Star us on GitHub — your support motivates us a lot! 🙏😊

Table of Contents

• Questarr
  • Table of Contents
  • List of features
  • Installation
  • Screenshots
  • Tech Stack
  • Configuration
  • Roadmap
  • Troubleshooting
  • Project Security & Documentation
  • Contributing
  • License
  • Acknowledgments

List of features

Supported Indexers/Downloaders

• Prowlarr synchronization is supported to add all your indexers at once.
• G4u.to: the site offers an API to VIP members, which can be used in Questarr.

SeerrNG integration

QuestarrNG provides SeerrNG with an IGDB catalog and request-scoped PC-game acquisition through a versioned, authenticated integration API. The contract keeps SeerrNG's request ID and selected OS/architecture attached to Questarr's tracked game and download records. See docs/API.md for the catalog, status, retry, cancellation, and imported-file streaming routes. Cancellation stops only downloads safely correlated to the SeerrNG request; completed files remain on disk, and ambiguous active downloads are refused. If Questarr restarts during a handoff before recording its download, it pauses the request for a duplicate-download check before retrying or cancelling. The retry or cancel endpoint returns 409 with confirmationRequired until the caller checks the download queue/history and sends confirmNoExistingDownload: true.

Installation

Docker is the easiest way to deploy Questarr with all dependencies included. Questarr uses a SQLite database which is self-contained in the application container.

Supported architectures: released Docker images are published for linux/amd64 and linux/arm64, so Questarr runs on a Raspberry Pi 4/5 with a 64-bit OS, other 64-bit ARM SBCs, and ARM-based NAS boxes as well as on x86 hardware. Docker selects the right architecture automatically — the commands below are identical on every platform. (32-bit ARM, e.g. armv7/a 32-bit OS on Raspberry Pi 3 and earlier, is not supported. The Home Assistant add-on is amd64-only.)

Option 1: One-liner (Simplest but minimal)

docker run -d -p 5000:5000 -v ./data:/app/data --name questarrng ghcr.io/snapetech/questarrng:latest

Option 2: Docker Compose (more detailed)

1. Use the docker-compose.yml file from the repo or create a minimal one:

   services:
     app:
       image: ghcr.io/snapetech/questarrng:latest
       ports:
         - "5000:5000"
       volumes:
         - ./data:/app/data
       environment:
         - SQLITE_DB_PATH=/app/data/sqlite.db
       restart: unless-stopped
   

2. Start the application:

   docker compose up -d
   

3. Access the application: Open your browser to http://localhost:5000

Proxmox VE (LXC)

bash -c "$(curl --fail --silent --show-error --location --proto '=https' --proto-redir '=https' https://raw.githubusercontent.com/Doezer/Questarr/main/scripts/proxmox/questarr-lxc.sh)"

UNRAID

CasaOS

Umbrel

Cosmos Cloud

Kubernetes (Helm)

git clone https://github.com/Doezer/Questarr.git
cd Questarr
helm install questarr charts/questarr --namespace questarr --create-namespace

kubectl port-forward -n questarr svc/questarr 5000:5000

Home Assistant Add-on

All platform definitions live in the repository and share the same mounts and ports — see docs/HOME_SERVER_APPS.md for details.

Screenshots

Tech Stack

• APIs: IGDB (game metadata), Torznab/Newznab (indexer search), PCGamingWiki, NexusMods, xREL.to
• AIs usage:
  • Claude and Github Copilot are used for AI-Assisted coding, internal code reviews, PR cleanup. Eventually automated coding and troubleshooting for small tasks and bug reports.
  • Gemini & Codex are used for automated code reviews, and brainstorming from time to time (as well as Perplexity for this usage).
  • Google Jules is used for light periodical refactoring.

Configuration

1. First-time setup:

• Create your admin account
• Configure the IGDB credentials

Once logged-in:

• Configure indexers
• Add downloaders
• Add games!

See Configuration on the Wiki for more detailed info.

git clone https://github.com/Doezer/Questarr.git
cd Questarr

docker-compose up -d

git pull
docker-compose down
docker-compose build --no-cache
docker-compose up -d

Roadmap

Based on the Product Requirements Document, here's what's planned over the next 6 months, in priority order:

• ✅ P0 — Post-Processing Pipeline : Move/copy completed downloads to a destination path, extract archives — closing the "set it and forget it" loop.
• P1 — Smart Game Backlog: Track the version of each downloaded game and notify (or auto-download) when a newer release shows up on indexers.
• P2 — Direct Download Support: Add debrid services (Real-Debrid and similar) as a downloader option, no seeding required.
• P3 — External Library Sync: Import owned games from Steam/GOG libraries and local filesystem scans, not just wishlists.
• P4 — Integrations with External Tools: ✅ Playnite extension shipped (library sync, request-to-download); RomM, Gameyfin, and a generic webhook for anything not explicitly supported are still planned.
• P5 — Indexer Page Links: A "View on indexer" link on search results and downloads.
• P6 — PostgreSQL Support: Re-introduce PostgreSQL as an optional backend, with SQLite remaining the zero-config default.

Ongoing: mobile responsiveness, search UX, performance, and security improvements.

See the full PRD for problem statements, detailed scope, and non-goals.

Troubleshooting

See Troubleshooting on the Wiki

If you run into an issue, go to the Logs page and click Send Logs before reporting it — it makes diagnosing the problem much easier.

Getting Help

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Discord: Join our Server

Project Security & Documentation

• Start with docs/GITHUB_DOCUMENTATION.md for the canonical documentation map.

Contributing

• See .github/CONTRIBUTING.md for guidelines on how to contribute to this project.
• See MAINTAINERS.md for the current list of project members with access to sensitive resources.

Contributors

Made with contrib.rocks.

Legal Disclaimer

Questarr is a self-hosted game manager designed solely for organizing, tracking, and automating game libraries using user-provided data and metadata APIs (such as IGDB). Questarr does not host, distribute, or provide any copyrighted game content, ROMs, or download links. It is a technology-neutral tool: any indexers, download clients, or sources you configure are chosen and operated entirely by you. You are solely responsible for ensuring that your use of Questarr, and any content you access or download through third-party services you configure, complies with all applicable laws and the terms of service of those third parties.

License

GPL3 License - see COPYING file for details.

Acknowledgments

• Inspired by Sonarr and GamezServer
• Game metadata powered by IGDB API
• UI components from shadcn/ui