Modulr

Open-source DJ companion for macOS. Analyse, tag, mix.

Stack

Swift + SwiftUI · AVFoundation · Accelerate · Python (essentia, madmom, librosa, ffmpeg, mutagen)

Requirements

macOS 14 (Sonoma) or later, the Xcode command line tools, Homebrew.

Install

From source

git clone https://github.com/johnshields/modulr.git
cd modulr
bash scripts/setup.sh        # one-time: brew + pip dependencies
bash scripts/run.sh --install

Homebrew (cask)

brew install --cask fromlost/modulr/modulr

Package a release

bash scripts/package.sh

Builds dist/Modulr-<version>.dmg and prints its sha256 for Casks/modulr.rb. Set DEVELOPER_ID and NOTARY_PROFILE to sign and notarise.

User guide

See _docs/user-guide.md for a walkthrough with screenshots.

Features

• BPM + key detection (Essentia edmm key profile and madmom CNN/RNN, with librosa fallback)
• Camelot-compatible key highlighting on the active track
• Search by title, key or BPM
• Tag editor with iTunes artwork finder
• Loudness measure and match (ffmpeg volumedetect)
• Tempo + pitch bake (asetrate + atempo)
• DJ-format rename title_KEY_BPM with edit-order drag reorder
• Bulk move, add and re-analyse tracks via sortable track-picker sheets
• Playlists, favourites and recents in a local SQLite database
• Rekordbox-style RGB waveform (low/mid/high mapped to red/green/blue)
• Spectrogram with frequency-energy colourmap and cutoff quality verdict
• Stereo meters, hover-scrub timer
• Follows the macOS system accent colour
• Folders sort newest-added first; playlists by track number
• Open With integration (single-instance window)

License

MIT. See LICENSE.