Skip to main content
Glama
Sign In
djlib

djlib

by uneasymusings
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

djlib

Tests, quality, and packaging

Check a DJ tracklist against your music. Build a crate in set order.

A local tool for rekordbox DJs. See which exact recordings you own, find missing tracks, and prepare your next set. Use the terminal or the small light-gray review page. No account required.

Try the demo · Install · Quick start

From tracklist to crate

A 15-second terminal walkthrough. Check a tracklist, then inspect the crate:

Four Tet terminal walkthrough: check eight tracks, then inspect the four-track crate

djlib set four-tet.txt --name 'Four Tet / Lollapalooza 2024' --no-rekordbox
djlib crate last

8 tracks → 4 owned · 2 other mixes · 2 missing. Only the four exact matches enter this example crate. Tracklist · Watch MP4

The clip uses generated audio and illustrative BPM/key, with real CLI output paced for readability. All five DJ walkthroughs: Avalon Emerson, Ben UFO, Four Tet, Floating Points and Skrillex.

Related MCP server: Luminous MCP Server

Install

In Terminal on macOS or Linux:

curl -LsSf https://raw.githubusercontent.com/uneasymusings/dj-library-tool/main/install.sh | sh

Choose your music folder when asked. djlib indexes it in place; your files stay where they are. On a Mac with Homebrew, missing audio helpers are installed too. The final setup check shows anything else needed. Windows and manual installation.

Then open your library:

djlib ui

Choose Import playlist or tracklist, paste your tracks or select a CSV, and Preview selection. Click Check against my music, then open the set and build its crate. If djlib is not found, open a new terminal. Install help · Optional Claude Code / Codex setup.

How it works

  1. Start with a tracklist, playlist CSV or set link. YouTube and SoundCloud links can use Shazam to help identify songs. Unknown tracks stay IDs.

  2. Check what you own. Exact mixes enter the crate. Other mixes and missing tracks stay visible. Rip and Shop are separate, optional choices.

  3. Prepare the set. Read saved BPM/key from rekordbox. On macOS, import the crate and export through rekordbox, then check the USB files and playlist order.

Already use the terminal? Copy a tracklist, then run djlib set paste on a Mac. A saved text file works on every platform. djlib crate last shows the next unfinished prep step; djlib upgrade updates the installed tool.

The catalog and background jobs stay on your computer. Scans reuse unchanged files, and interrupted jobs can resume. Set identification contacts the chosen web providers; an hour-long mix usually takes 5–10 minutes, sometimes longer. Workflow details.

For developers

Python, FastAPI and SQLite power the CLI, authenticated local service and MCP tools. Durable jobs, immutable audio revisions and explicit workflow records keep matching, analysis and USB checks traceable. The same frontend runs the local review page and the read-only public demo.

CI checks Linux, macOS and Windows on Python 3.12 and 3.13, including fresh installed packages. Architecture · Contributing · Validation · Security.

Alpha (0.1.0a23). Native rekordbox and USB controls require macOS. Shazam is unofficial and may slow down or stop working. USB file checks do not prove CDJ playback; test your player before a gig. Limits.

MIT licensed. Bring your own music and download rights. Not affiliated with AlphaTheta/rekordbox, Shazam/Apple, MixesDB or 1001Tracklists.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • spotify-dj

      cikeyz
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables DJs to retrieve BPM, key/Camelot, energy, and other track metadata with provider provenance, score transitions, plan setlists, and control Spotify playlists and playback with staged, revalidated writes for safety.
      MIT

    • Luminous MCP Server

      esoltys
      A
      license
      Not graded
      quality
      B
      maintenance
      Connects AI assistants to a local music library for full-text search and filtering of tracks, albums, artists, genres, composers, and lyrics, plus listening analytics and metadata hygiene audits. Also lets users generate and populate playlists and control playback (play, pause, seek, volume) in a running player instance.
      MIT

    • library

      shadowroommusic
      A
      license
      A
      quality
      C
      maintenance
      Manages a local SQLite music track library with fingerprint-based incremental scanning, multi-condition search, missing analysis completion, and crate management, enabling DJs to organize and retrieve tracks without moving files.
      13
      AGPL 3.0

    • engine-dj-mcp

      Venut-Technologies
      A
      license
      A
      quality
      A
      maintenance
      Enables AI assistants to query and manage a local Engine DJ library on macOS, including searching tracks by BPM, key, genre, or comments, auditing duplicates and missing files, reading cues and beatgrids, and building playlists or fixing tags when write access is enabled.
      9
      109 npm
      1
      MIT