DJ TOOLS · FREE · WINDOWS

Check your USB before the gig.

rekordbox USB check is a small Windows tool that scans a USB stick exported from rekordbox and finds problems before you plug it into a CDJ or XDJ: missing files, damaged tracks and database issues that end up as an E-xxxx error in the booth.

  • Version0.1.2
  • SystemWindows 64-bit
  • Playersany Pioneer DJ / AlphaTheta CDJ and XDJ
  • Saferead-only, never writes to the drive
  • Pricefree

/WHAT IT CHECKS

rekordbox USB · CDJ · XDJ

As a DJ I kept running into the same traps: a track that plays fine on my laptop but won't load on the club's CDJ, a file that silently went missing during export, an error code in the middle of a set. I wrote this tool for myself, then polished it and decided to share it with the DJ community.

rekordbox databases

Reads the export databases on the stick and checks that every track they list really is there and can be opened by the player.

Media files

Reads every byte of every file in the Contents folder and decodes the audio, so it catches damaged or unreadable tracks.

Your player

Checks against a player profile (by default a modern club setup). Other profiles cover older and different CDJ/XDJ models.

The result is an HTML report that opens in your browser and tells you exactly which tracks would fail and why.

/DOWNLOAD

two versions · pick one

Both zips contain the same tool. The only difference is whether ffmpeg is included. Not sure? Take the full version.

if you're not sure

Full version

Complete package with the ffmpeg binaries the tool needs. Works out of the box. Extracts to over 200 MB on disk.

rekordbox-usb-check-0.1.2-win64.zip

90 MBzip · Windows 64-bit

↓ Download full version

Without ffmpeg

Tiny package for when you already have ffmpeg.exe and ffprobe.exe installed. As a DJ, you probably do.

rekordbox-usb-check-0.1.2-win64-no-ffmpeg.zip

15 MBzip · Windows 64-bit

↓ Download without ffmpeg

Installation takes a minute: see the steps below.

/INSTALL

no installer · just unzip

  1. Download the right zipFull version or without ffmpeg, see above.
  2. Optional: unblock the zipRight-click the downloaded zip, choose Properties and tick Unblock. Only needed if Windows starts warning you about extracted files being “downloaded from the internet”. If there is no such option, you're good to go.
  3. Unzip anywhereExtract the contents into any folder you like.
  4. That's allThe checker is ready to use.

/USAGE

double-click and wait

Full check

Plug in your USB stick. In the unzipped folder go to the rbcheck subfolder and double-click:

rekordbox-usb-check.bat

It finds the inserted USB drives, checks the one you pick and opens the report in your browser.

Quick check

When you're short on time, double-click:

rekordbox-usb-quick-check.bat

It checks the rekordbox databases only, without reading the media files in Contents. Much faster, but it won't catch damaged tracks.

Command-line options

For more control, run rekordbox-usb-check from a terminal. Tip: run it with --write-manifest right after exporting, and with --verify-manifest before the gig to see whether anything on the stick has changed.

usage: rekordbox-usb-check [-h] [--profile PROFILE] [--list-profiles] [--quick]
                           [--no-read-test] [--html HTML] [--json JSON] [--no-open]
                           [--write-manifest FILE] [--verify-manifest FILE] [--pause]
                           [volume]

Check a rekordbox USB drive before a gig. Read-only; it never writes to the drive.

positional arguments:
  volume                 Drive or folder to check. Auto-detected if omitted.

options:
  -h, --help             show this help message and exit
  --profile PROFILE      Which player to check against (default: club-modern).
                         Use --list-profiles to see all.
  --list-profiles        Show every player profile and exit.
  --quick                Skip the full decode pass. Much faster, misses damaged files.
  --no-read-test         Skip reading every byte of every file.
  --html HTML            Where to write the HTML report.
  --json JSON            Also write machine-readable JSON here.
  --no-open              Do not open the report in a browser.
  --write-manifest FILE  Fingerprint the drive and save it. Run this right after exporting.
  --verify-manifest FILE Compare the drive against a saved fingerprint.
  --pause                Wait for a keypress before closing (for double-click use).

/THANKS & FEEDBACK

bugs · ideas · thank-you notes

I didn't make it for the money. If it saved your set, follow Damago_DJ on Instagram and drop me a thank-you note. That's all.

damago1@gmail.com
DAMAGO · DJ · Warsaw · tools for DJs Damago DJ Back to top