Questarr

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.

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.

Option 1: One-liner (Simplest but minimal)

docker run -d -p 5000:5000 -v ./data:/app/data --name questarr ghcr.io/doezer/questarr: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/doezer/questarr: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

UNRAID

Home Assistant Add-on

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, RomM, Gameyfin, and a generic webhook for anything not explicitly supported.
• 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