kevycito

02 / App

My USB

Vibecoded

My USB scans my music folders, works out the BPM, key and energy of every track, and shows what mixes with what. I built it with AI for my own collection.

01 / Rundown

What it is for

A folder of music files does not say how fast a track is, what key it is in, or what to play next. My USB works that out and keeps it all in one library. A session goes in four steps.

Step 1

Scan

Point it at a folder. It reads mp3, wav, aif, flac, m4a, aac and ogg files and never writes to them.

Step 2

Tag

Each track gets a BPM, a key, an energy score and cue points. The AI pack adds genre and mood.

Step 3

Match

Pick a track and see which of mine mix after it, ranked by fit, with how ready the beat match is.

Step 4

Map

Every track lands on a map by how it sounds, so tracks that feel alike sit close together.

02 / Features

What it does

Nine parts, in three groups: the library itself, set prep, and what reaches past the PC.

Library / Scan

Reads folders in the background

Progress shows in a status bar and each track fills in as it finishes. A re-scan skips unchanged files, finds moved ones and dims missing ones, so playlists keep their tracks.

Library / Analyze

BPM, key, energy and cues

A quality check flags files that look cut off at the top of the range. With the AI pack, two models add genre, subgenre and mood. Without it the app still runs on signal analysis alone.

Library / Match

Next up

For any track, a mix fit from 0 to 1, a tier (clean, creative or jump) and a beat match score out of 100. Two copies of one track show as one row.

Set prep / Map

Vibe map

A scatter map of the whole library by sound. Graph playlists, Magic Sort and Auto Group sit beside it as set-prep tools.

Set prep / Chapters

Chapter Builder

Split a set into chapters, such as warm-up and momentum, and get track suggestions for each one.

Set prep / Export

Out to other software

Sets export as rekordbox XML with beat grids and cues, or as M3U8 playlists. A merge mode only adds cues to an existing rekordbox collection. It can import one too.

Beyond the PC / Discover

Find music and a To buy list

A weekly run looks for new releases from my artists and labels. Cards play a 30 second preview. Buying opens the store in a new tab.

Beyond the PC / From sets

What other DJs play

It reads the track lists of DJs I pick, at a human pace, and stops at any bot check. It shows what is climbing and what is new to me. Set Autopsy shows how one set was built.

Beyond the PC / Phone

The library on a phone

Behind a private sign-in, the phone is built to browse, filter and play tracks, with the screen locked too, and to save to a playlist. Set building stays at the PC. Scripted checks pass; a check on a real phone is still open.

03 / Gallery

The screens

These are drawings of each screen with made-up track names. Real screenshots are not on this page yet. Select one to see it full screen.

Illustration of the library: a table of tracks with BPM, key, energy and quality columns, filter chips, and a scan progress bar.
Illustration: the library, with filters and a scan running.
Illustration of one track's analysis: a waveform with sections, four cue flags, phrase levels, a vocal map and BPM, key, energy and quality readouts.
Illustration: one track's analysis, with sections and cues.
Illustration of Next up: the playing track on the left, and a ranked list of tracks that mix after it with a fit score, a tier and a beat match bar.
Illustration: Next up ranks what mixes after the playing track.
Illustration of the vibe map: five clusters of dots on a grid with a dashed path of four stops across them.
Illustration: the vibe map, with a path across it.
Illustration of the chapter builder: an energy curve above four chapters named warm-up, momentum, peak and cool-down, each holding track cards.
Illustration: a set split into chapters, ready to export.
Illustration of the phone view: a phone showing a track list and a player bar, with notes on what the phone can and cannot do.
Illustration: the phone view.

04 / Numbers

How well it works

These come from the acceptance run on Nov 8 2026, measured on a desktop PC. Where a number is from a small test library, the chart says so.

Tests passing

1,685

767 for the UI, 918 for the engine

Answer key, BPM

13/14

Within 0.5 of the tag. The miss read double.

Answer key, key

14/14

Exact match on 14 store-tagged tracks

First scan, files/s

253

18 files. Reading tags alone: 802 files/s.

Speed on a big library

Answer time, 20,000 tracks

Answer time in milliseconds on a 20,000-track library. Track list filter 60, limit 200. Matching 26, limit 300. Graph selector 63, limit 300. Track list filter 60 ms limit 200 ms Matching 26 ms limit 300 ms Graph selector 63 ms limit 300 ms

Milliseconds on a 20,000-track test library. The track list filter is a 95th percentile (p95). Lime is measured, grey is the limit it had to stay under. Measured on a desktop PC.

Speed on a big library

Vibe map build, 20,000 tracks

Measured37 s Limit180 s

Seconds to place a 20,000-track test library on the map. Measured on a desktop PC.

Phone, emulated

Phone speed on slow 4G

Phone speed in milliseconds on an emulated slow 4G connection. First row, cold load 1,547, limit 3,000. Filter and sort at idle 271, limit 500. Filter and sort during re-analysis 287, limit 750. First row, cold load 1,547 ms limit 3,000 Filter and sort, idle (p95) 271 ms limit 500 Filter and sort, during re-analysis (p95) 287 ms limit 750

Milliseconds. A 390 by 844 phone on a slow 4G profile, on a 2,000-track test library, run without the remote sign-in check. Measured on a desktop PC.

Phone, emulated

Phone data use

Phone data use in kilobytes. Page shell on first load 247.4, limit 250. First page of tracks 3.1, limit 40. Idle for one minute 0.8, limit 5. Library open during re-analysis for one minute 24.4, limit 50. Page shell, first load 247.4 KB limit 250 First page of tracks 3.1 KB limit 40 Idle for one minute 0.8 KB limit 5 Library open during re-analysis, one minute 24.4 KB limit 50

Kilobytes sent to the phone, on a 2,000-track test library. The last bar ran through the tunnel listener the live app uses. Measured on a desktop PC.

Test suites

Tests passing, by suite

UI767 Engine918 Speed and live app19 AI models12 Real audio5

Tests passing, run on a desktop PC. The headline 1,685 is the UI and engine suites. The other three suites run apart from them.

Not yet checked

Still open

Opening an exported set in rekordbox by hand is still to do. Only the file format is tested so far.

The phone view passes its scripted checks. The check on a real phone is not done.

Key reading has a known limit. On synthetic loops over a saw bass, 11 of 12 minor loops read as the major key. The real answer key stays 14 of 14.

05 / Next

Where next

My USB stays with me. If DJing is new to you, there is a guide for that.

My USB is not available to download or buy. It is a tool for one collection.

New to DJing? Start here