Listen to one of my mixes while you read?

DJ USB T[ool]kit 0.3.0

Estimated reading time 7 min
Created: 1.10.2026, 17:15 - Updated: 7.11.2026, 03:56
DJ USB Tkit
Made: 1.10.2026, 17:13

Overview#

DJ USB T[ool]kit is a local-first desktop app for getting DJ USB drives ready for CDJ/XDJ players. It needs no cloud connection and no account. The 0.2.5 post covered the 0.2 series: the cue point and beat-grid editor, faster analysis and import, backups, and the wider set of repair tools.

Version 0.3.0 is the latest release. Its main theme is bringing your existing library with you. The app can now import tracks, cues and playlists from rekordbox and Mixxx. This release also detects BPMs more accurately and adds a USB repair for audio files that are on the drive but in no playlist.

What's new in 0.3#

Import from rekordbox and Mixxx#

The app finds rekordbox's library (`master.db`) and Mixxx's library (`mixxxdb.sqlite`) on the same computer by itself. Each one found gets a chip in the Media Library's new **Libraries** row, and the chip's ↻ button imports that library. Both databases are only read. Nothing is written back, and rekordbox or Mixxx can stay open while you import.
  • Track data. Title, artist, album, genre, BPM, key, length and cover image come along. rekordbox tracks keep using rekordbox's own analysis files. Mixxx tracks are analyzed by the app, because Mixxx stores waveforms and beat grids in its own formats.
  • Your BPM and key are kept. The first analysis of an imported track keeps the imported BPM and key, so a tempo you corrected in rekordbox or Mixxx isn't lost. "Reanalyze" replaces them with the app's own detection. Importing again picks up a BPM or key you changed in rekordbox or Mixxx, but never overwrites one you edited in the app.
  • Hot cues. Mixxx hot cues come in with position, colour and label, and Mixxx's main cue becomes the playback-start cue. From rekordbox, hot cues (pads A–H) come first. A memory cue before the first hot cue becomes the playback start, and the other memory cues fill the free cue slots. A track set up with only memory cues, the way older players need, gets its first memory cue as the playback start and the next 8 as cue points. Cues are only added to tracks that don't have cues in the app yet.
  • Tracks are never lost to a missing drive. If an imported track's file isn't found, for example because its drive is unplugged, the track stays in the app with its playlists and cues, and the Event Log lists it as not found.

Import playlists#

The sidebar's Playlists section gets an Import button when rekordbox or Mixxx is found. It lists the playlists and history sessions that have tracks, plus Mixxx crates. rekordbox playlists inside folders show as "Folder / Name". The one you pick becomes an app playlist in the same order, with its tracks and hot cues imported as above.

Importing the same playlist again updates the playlist it made the first time (tracks and order) and keeps the name you gave it. "Force update track data" replaces the tracks' BPM, key and cues with the library's, including your own edits. Smart playlists aren't listed, because rekordbox doesn't store their tracks.

More accurate BPM#

Analysis now finds half BPMs such as 87.5 and corrects estimates that are up to 2 BPM off, instead of always rounding to a whole number. Half values matter most for slow tracks whose double is the real tempo (87.5 → 175). Each nearby whole and half BPM is checked against the whole track. When none clearly fits, the BPM is rounded as before.

On a sample of 218 library tracks, the detected BPM matched the reference for 197 tracks, up from 139. Track lists now show BPM with two decimals ("128.00", "87.50").

USB repair: unindexed audio#

After restoring a drive's databases from an older backup, there can be audio files on the drive that no playlist points to. The USB repair can now add them to a USB playlist called Unindexed. Their existing analysis is reused, and nothing is copied or deleted. When a track's file was renamed or moved on the drive, the repair points the track at the file it finds, so the track stays in its playlists.

Cleaner pages#

  • Every page title has the same style, and each page's buttons sit next to its title, so they stay visible while the page scrolls. On the USB Browser, "Rediagnose USB", "Parity Report" and "Preview Fixes" moved up next to the title.
  • Drives are shown by their name everywhere instead of their mount path.
  • The cue editor opens on the first 60 bars at the track's BPM instead of the first two minutes, so beat lines are spaced the same whatever the tempo. Lines too dense to read are hidden until you zoom in.
  • The Parity Report explains what it checks, and what a FAIL means on the players.

Also new since 0.2.5#

  • Key notation (0.2.8). Show keys as classic (Am) or Camelot (8A). It only changes the display. Exports keep the classic key name, which every CDJ/XDJ reads. Sorting by key follows the Camelot wheel in both notations.
  • BPM/key consistency check and repair (0.2.7). Diagnostics compares BPM and key between the drive's two databases, and a repair brings them and the beat grid back in step. This came with a critical fix: before 0.2.7, saving BPM or key from the cue editor on a USB row didn't update export.pdb, so some players kept showing the old values. If you edited tracks on a USB with an earlier version, run this repair.
  • Cue editor polish (0.2.8–0.2.9). Saving to a USB no longer freezes the window and shows its progress. The editor picks up a track that's already playing. All eight hot cue slots are always shown.
  • XDJ-1000MK2 tested (0.2.6). The first XDJ in the hardware test matrix passed every scenario.
  • Older Linux distros (0.2.6). The AppImage runs on Ubuntu 22.04, Linux Mint 21 and other glibc 2.35 distros, and software centres show a description and screenshot.
  • A smaller frontend. The production bundle went from 447 KB to 211 KB, and all HTML now lives in templates instead of being built in JavaScript.

Status & access#

License: AGPL-3.0-or-later (MIT up to 0.1.x)
Availability: Public release (v0.3.0), open source
Platforms: Linux (deb/rpm/AppImage), macOS, Windows
Requirements: Prebuilt binaries don't need Node.js. Building from source, or using the optional essentia analysis engine, does.

More on the imports: External libraries (rekordbox + Mixxx)

Support & Download#

DJ USB T[ool]Kit lahjoitukset

Download

Latest version 0.6.3 ·

Release notes and all files on GitHub

You may also like

plugin.jpg plugin.jpg
Projects

entropy.fi - Stripe integration

Entropy.fi website
IMG_20191113_195243.jpg IMG_20191113_195243.jpg
Art

Helsinki UG partymap

entropy_header.jpg entropy_header.jpg
Projects

Entropy.fi progress, July–December 2025

Entropy.fi website