CrateDigger

Festival set & concert library manager

Organize, enrich, and curate your collection with professional artwork, metadata, and chapter markers.

Martin Garrix at Red Rocks poster
Tomorrowland album poster
Swedish House Mafia at UMF poster
EDC Las Vegas album poster
Tiesto at EDC Las Vegas poster

Your library, perfected

Identify

Match your recordings against 1001Tracklists. Embed tracklist metadata and chapter markers directly into MKV files for track-by-track navigation.

Organize

Four flexible folder layouts with smart filename templates. Sonarr-style collapsing tokens handle optional fields gracefully. Copy, move, or rename in place.

Enrich

Generate professional posters, extract cover art, download HD artist images from fanart.tv, create Kodi-compatible NFO files, and embed MKV tags.

Kodi Sync

Auto-refresh your Kodi library via JSON-RPC after enrichment. Automatic path mapping for multi-storage setups. NFO files integrate seamlessly.

From raw files to curated library

1

Identify

Match recordings against 1001Tracklists. Embed metadata and chapter markers for track-by-track navigation.

cratedigger identify ~/downloads/sets/
2

Organize

Move or copy files into your library with smart folder layouts and filename templates.

cratedigger organize ~/downloads/sets/ --output ~/library/ --move
3

Enrich

Generate artwork, posters, NFO files, download artist images, and embed tags.

cratedigger enrich ~/library/ --kodi-sync

Up and running in minutes

Prerequisites

Install

Terminal
pip install git+https://github.com/Rouzax/CrateDigger.git

Optional: install with vision support for advanced frame analysis

Terminal
pip install "cratedigger[vision] @ git+https://github.com/Rouzax/CrateDigger.git"