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.

Features

• Game Discovery: Browse popular games, new releases, and upcoming titles via IGDB integration
• Library Management: Track your game collection with status indicators (Wanted, Owned, Playing, Completed)
• Download Management: Optionally integrate with indexers (Prowlarr/Torznab/Newsznab), torrent/usenet downloaders (qBittorrent, Transmission, rTorrent / sabnzbd, nzbget), and optionally enable auto-download to get them right when they're there.
• Search & Filter: Find games by genre, platform, and search terms. Automatically search for added games until available on your indexers.
• Clean Interface: UI optimized for browsing game covers and metadata, with light/dark mode

Tech Stack

• Frontend: React 18, TypeScript, Vite, Tailwind CSS, shadcn/ui
• Backend: Node.js, Express, TypeScript
• Database: PostgreSQL with Drizzle ORM
• APIs: IGDB (game metadata), Torznab (indexer search)
• AIs: Claude Sonnet 4.5, Gemini 3, Google Jules, GitHub Copilot

Installation

Prerequisites

• Docker & Docker Compose (recommended) OR
• Node.js 20+ and PostgreSQL 16+
• IGDB API credentials (required for game discovery)

Using Docker Compose (Recommended)

Docker Compose is the easiest way to deploy Questarr with all dependencies included.

1. Clone the repository:

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

2. Create environment file:

cp .env.example .env

3. Configure environment variables in .env:

# Required: IGDB API credentials (get from https://dev.twitch.tv/console)
IGDB_CLIENT_ID=your_client_id_here
IGDB_CLIENT_SECRET=your_client_secret_here

# Optional: Server configuration
PORT=5000
HOST=0.0.0.0
NODE_ENV=production

# Database (already configured for Docker)
DATABASE_URL=postgresql://postgres:password@db:5432/questarr

1. Build and start the containers:

docker-compose up -d

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

2. First-time setup:

• Create your admin account on first visit
• Configure indexers
• Add downloaders

Update to latest version:

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

Manual Installation (npm)

For development or custom deployments without Docker.

1. Clone and install dependencies:

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

2. Set up PostgreSQL:

• Install PostgreSQL 16+ on your system
• Create a database: createdb questarr
• Create a .env file with your database connection string

3. Configure environment variables in .env:

DATABASE_URL=postgresql://user:password@localhost:5432/questarr
IGDB_CLIENT_ID=your_client_id
IGDB_CLIENT_SECRET=your_client_secret
PORT=5000

4. Initialize the database:

npm run db:migrate

5. Build and start:

Development mode (with hot reload):

npm run dev

Production mode:

npm run build
npm start

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

Configuration

See Configuration on the Wiki for more detailed info.

Getting IGDB API Credentials

IGDB provides game metadata (covers, descriptions, ratings, release dates, etc.).

1. Go to Twitch Developer Console
2. Log in with your Twitch account (create one if needed)
3. Click "Register Your Application"
4. Fill in:
   • Name: Questarr (or any name)
   • OAuth Redirect URLs: http://localhost (not used, but required)
   • Category: Application Integration
5. Click "Create"
6. Copy your Client ID and Client Secret
7. Add them to your .env file

Troubleshooting

See Troubleshooting on the Wiki

Getting Help

• Issues: GitHub Issues
• Discussions: GitHub Discussions

Contributing

See CONTRIBUTING.md for guidelines on how to contribute to this project.

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