Skip to content

CrateDigger

Festival set and concert library manager. CrateDigger organizes, enriches, and tags your media files with artwork, metadata, and chapter markers.

What it does

CrateDigger takes a collection of festival sets and concert recordings and turns them into a well-organized, richly tagged media library. It handles everything from matching tracklists and embedding chapter markers to generating poster artwork and syncing with Kodi.

Three-command workflow

CrateDigger follows a simple pipeline:

  1. Identify: Match recordings against 1001Tracklists, embed chapter markers and metadata tags into MKV files.
  2. Organize: Move or copy files into a structured library with smart folder layouts and consistent filenames.
  3. Enrich: Add cover art, fanart, poster images, NFO files, and MKV tags to your library.

You can run each step independently, or chain them together. The organize command can optionally run enrichment in a single pass with --enrich.

Quick start

# Install from GitHub
pip install git+https://github.com/Rouzax/CrateDigger.git

# Identify tracklists and embed chapters
cratedigger identify ~/Downloads/sets/

# Organize into a library
cratedigger organize ~/Downloads/sets/ --output ~/Music/Library/

# Enrich with artwork and metadata
cratedigger enrich ~/Music/Library/

See the Getting Started guide for detailed setup instructions.

Additional tools

  • Audit Logos: Check which festivals in your library have curated logo artwork available for poster generation.
  • TrackSplit: A sibling CLI that extracts chapter-based audio from your video library into gapless, tagged FLAC albums for music servers like Jellyfin and Lyrion. TrackSplit reads CrateDigger's festival and artist config, so canonical naming and MusicBrainz IDs stay consistent across your video and music libraries. CrateDigger emits per-chapter PERFORMER and GENRE tags (Matroska TargetTypeValue=30) that TrackSplit picks up via ffprobe to write accurate per-track FLAC metadata. See the TrackSplit documentation or source on GitHub.

Learn more