Claudio

A self-hosted game library manager for organizing, browsing, and downloading your game collection.

Features

Library Management

Automatically scans your game directories and organizes them by platform. Supports PC, Mac, Linux, Switch, PlayStation, Xbox, and more.

Rich Metadata

Auto-matches games against IGDB for covers, summaries, genres, developers, and release dates. SteamGridDB integration for additional cover art.

File Browsing & Downloads

Browse game folder contents in the browser — including inside zip and tar archives. Download games with resume support.

Flexible Authentication

Local accounts, GitHub, Google, any OpenID Connect provider, or reverse-proxy SSO. Your choice.

Run the container

docker run -d \
  --name claudio \
  -p 8080:8080 \
  -v /path/to/games:/games:ro \
  -v claudio-data:/config \
  ghcr.io/lmrisdal/claudio:latest

Open the UI

Navigate to http://localhost:8080 and register your first user — they automatically become admin.

Organize your games

Structure your library by platform:

/games/
  pc/
    Hades II (2025)/
    Celeste (2018)/
  switch/
    The Legend of Zelda Breath of the Wild (2017)/

Add metadata (optional)

Set CLAUDIO_IGDB_CLIENT_ID and CLAUDIO_IGDB_CLIENT_SECRET to pull covers, summaries, and more from IGDB automatically.

Installation Docker and Docker Compose setup, including PostgreSQL.

Configuration All environment variables and config file options.

Authentication Local accounts, OAuth, OIDC, and proxy auth.

Development Set up a local dev environment and learn the architecture.