CHECKING YOUR USB STICK BEFORE A GIG
====================================

Idea and development by Marcin Gosiewski, Damago_DJ

Pre-gig sanity check for rekordbox-exported USB drives.
This is supposed to be a kind of chkdsk for DJs struggling with the usual
errors you see on a CDJ when using rekordbox-exported USB sticks.

The thing got worse with the introduction of OneLibrary, and AlphaTheta
made it worse still with the infamous rekordbox 7 update that was physically
destroying USB tracks on export.


What it checks, in summary
--------------------------
- differences between OneLibrary and the older Device Library
- tracks in a library with no audio file on the stick, and the reverse
- files in a format the club's players cannot decode
- damaged files that stop part-way through
- disaster cases like a database that will not open at all

Every item in the report explains itself, so there is no list to memorise.


What this does
--------------
It reads the stick and tells you whether every track will actually load on the
players you are going to meet. It catches missing files, files that were only
half copied, files in a format the player cannot decode, playlists that open
empty on one kind of deck, and tracks that exist in one of the stick's two
libraries but not the other.

Some of these announce themselves on the player -- NO FILE, or CANNOT PLAY
TRACK. The dangerous ones do not. A half-copied track loads, tells you it is
six minutes long, plays two, and stops dead with no error at all. In front of a
room, that looks like your mistake.

It never writes anything to the stick. It cannot damage your music.


How to use it
-------------
1. Plug in the USB stick.
2. Double-click "rekordbox-usb-check.bat".
3. Wait. A few minutes is normal -- it reads every file end to end.
4. A report opens in your browser. Red items will fail in the club.

That's it.


The first time you run it
-------------------------
Windows may show a blue box saying "Windows protected your PC". This happens to
any program that has not been through Microsoft's paid signing process.

Click "More info", then "Run anyway".

If you downloaded this as a zip, right-click the ZIP FILE first, choose
Properties, tick Unblock at the bottom, then extract it. If you extract before
unblocking, Windows tags every file inside and the program will not start.


If it says your stick is not ready
----------------------------------
Almost every problem has the same fix: export the whole stick again from
rekordbox on a computer, rather than editing it on the player. Changes you make
on the player itself often do not reach the older library format that club CDJs
read.

Each item in the report tells you what to do under "Do this:".


Checking against a specific player
----------------------------------
By default it checks against a CDJ-3000 or CDJ-2000NXS2, which is what most
clubs have. If you are playing somewhere with older gear, open a Command
Prompt in this folder and run:

    rekordbox-usb-check.exe --profile club-legacy

That is the strictest setting. It will reject every FLAC file, because
CDJ-2000NXS and older players genuinely cannot play them.

To see all the options:

    rekordbox-usb-check.exe --list-profiles
    rekordbox-usb-check.exe --help
