Blendbook reads your rekordbox history, chains blends you've already played into your next set, and sends it back as a playlist. It brings back favourites you dropped, and while you mix it suggests the next track and warns when both basses are up.
Free and open source, no account. Needs rekordbox 6 or 7 with a set in its History, and Chrome or Edge.
Plan a set
124 → 129 BPM · 7 tracks
124129
Track energyThe shape you asked for
1
Glasshouse
Mara Vey
your opener
1248A
2
Low Tide Signal
Okono
played 4× after this
1258A
3
Night Bus North
Halden & Rue
harmonic 8A→9A
1269A
4
Paper Lanterns
Ines Calder
forgotten favourite
1269A
5
Concrete Bloom
Tov Arlen
never played out
12710A
6
Second Sun
Okono
easy blend
12810A
7
Last Train Out
Mara Vey
your go-to closer
12911A
An example with made-up tracks. Pick a shape: yours is built from your own history.
Sent to rekordboxBlendbook › Warm-up from Glasshouse7 tracks · your library backed up first
rekordbox 6 or 7
Mac and Windows
Chrome or Edge for Live and MIDI
Runs offline; new-music search is opt-in
MIT licensed
What it does
Tonight's set, from the blends you already know work.
rekordbox already logs every set. Blendbook uses that history, with tempo, key and energy from rekordbox's own analysis, to plan the next one and review the last.
Live
Know what's next, mid-mix.
Follows your set as rekordbox logs it, ranks your library for the next track, and watches both basses on your controller.
Now playing
Night Bus North
Halden & Rue · 126 BPM
about 2:10 left
Play next
Paper Lanterns
next in your plan
126 · 9A
Both bass EQs are up. Pull one down: 6 s and counting.
A phone view follows the same set, for reading the next track with the laptop on the booth.
Taste
Find what you forgot you loved.
Your signature blends, the favourites you've dropped, and the part of your library that has never left the house.
Forgotten favourites
Paper Lanterns
Ines Calder · 126 BPM · 9A
played 9×, last in March
Harbour Lights
Tov Arlen · 122 BPM · 6A
played 6×, last in January
Never played out
Concrete Bloom
Tov Arlen · 127 BPM · 10A
in your library 14 months
Glass Garden
Ines Calder · 125 BPM · 7A
in your library 9 months
Sessions
See what last night actually did.
What happened, where tempo or energy slipped, and one habit to work on next time.
Tempo through the set
gap · 1:42
16tracks
2h 4mlength
94%smooth tempo
2 possible gaps between tracks. Load the next one before the outro, or hold a 4-beat loop.
Dig
New music that fits the set you're building.
Artists like the ones in your plan, filtered to its sound and tempo, each with a 30-second preview and links to Apple Music, Spotify and Beatport.
Dig around this set
Salt & Static
Rue Maren · like Halden & Rue
126 BPM · ≈9A
Under the Flyover
Kestrel Dawn · like Okono
125 BPM · ≈8A
Morning Shift
Mara Vey · more Mara Vey
128 BPM · ≈10A
Night Ferry
Kestrel Dawn · like Mara Vey
124 BPM · ≈8A
How it works
Open it. Your sets are already there.
Deck 1
126
BPM · an illustrated mix
1
2
Deck 2
It starts with your history.
Blendbook reads a copy of your rekordbox library, never the live one.
It finds the blends you've already played.
Track to track, the transitions that worked for you before, chained by tempo, key and energy.
And hands back a playlist.
In its own Blendbook folder in rekordbox, after a backup.
Every set you've played is a lesson. Blendbook reads it back to you.
Privacy
Your library stays on your computer.
No account, no analytics, no tracking. Blendbook runs on your machine and opens in your browser. Even this page loads nothing from anyone else.
Nothing is uploaded. Every number and takeaway is worked out locally.
Online only when you ask. Finding new music sends artist names and track titles, and nothing else.
Open source. Read every line on GitHub, or build it yourself.
Set up
Three ways to install it.
You need rekordbox 6 or 7 with at least one set in its History, and Chrome or Edge for every feature.
Download the app
The quickest way. Python and everything else is built in.
Look for the address. It prints Blendbook … running at http://localhost:8080 and opens your browser. If 8080 is busy it takes the next free port.
Check the badge. Top right should read "rekordbox · N sets". If it says rekordbox wasn't found, open Settings, press Choose folder… and pick the folder that holds master.db.
Optional: install ffmpeg to analyse mix recordings, and add an Anthropic API key in Settings for free-form coaching.
The full guide, with troubleshooting, is in SETUP.md.
Let an AI set it up
Paste this into a coding assistant that can run commands on your computer, such as Claude Code, Cursor or Codex. It checks what you have, installs Blendbook from source, and confirms it reads your library. In a plain chat app it works as a step-by-step guide.
Help me set up Blendbook on this computer. It's a free, open-source companion app for rekordbox DJs: https://github.com/ujjaidasani/blendbook
Work through these steps one at a time. Run the commands yourself if you can, otherwise tell me exactly what to type. Wait for me whenever a step needs my input.
1. Check what I have: my operating system (macOS or Windows), Python 3.12 or newer (python3 --version, or py --version on Windows), git, and rekordbox 6 or 7 with at least one set in its History. If Python or git is missing, tell me the simplest way to install it, then wait.
2. Get the code: git clone https://github.com/ujjaidasani/blendbook.git, then work inside the blendbook folder.
3. Create a virtual environment in .venv and install requirements.txt into it.
macOS: python3 -m venv .venv, then .venv/bin/pip install -r requirements.txt
Windows: py -m venv .venv, then .venv\Scripts\pip install -r requirements.txt
4. Confirm the install by running the tests with the virtual environment's Python: python -m unittest discover -s tests. They should all pass.
5. Start Blendbook with the virtual environment's Python: python app.py. It prints "Blendbook ... running at http://localhost:8080" and opens my browser. If port 8080 is busy it uses the next free one, so read the address it prints.
6. Check it worked: the badge at the top right of the page should say "rekordbox · N sets". If it says rekordbox wasn't found, help me find the folder that holds master.db (macOS: ~/Library/Pioneer/rekordbox, Windows: %APPDATA%\Pioneer\rekordbox) and set it in Settings, Choose folder.
7. Optional extras. Ask me before each one:
- ffmpeg, for analysing mix recordings (macOS: brew install ffmpeg, Windows: winget install ffmpeg).
- An Anthropic API key, for free-form coaching. Don't ask me to paste a key into this chat. I'll type it into Blendbook's Settings myself.
Rules:
- Blendbook only reads a copy of my rekordbox library. Don't change, move or delete anything in the rekordbox folder.
- Don't use sudo or administrator rights, and don't install anything system-wide without asking me first.
- I should use Chrome or Edge for the Blendbook page.
- If a step fails, show me the exact error and fix that before moving on.
Finish by telling me how to start Blendbook next time, and how to stop it.