rekordbox-edit
A command-line tool for bulk operations on your Rekordbox library. Search tracks, edit metadata, and convert between audio formats with the benefit of database updates that preserve all your cues, analyses, and metadata.
[!CAUTION] This tool can modify your Rekordbox database and audio files. Always back up your data first. No warranty is provided--you assume all risk and liability of data loss in using this. See Safety and Best Practices
[!WARNING] This project is in active development with no stable version released yet. Breaking changes are likely to occur across version 0 releases until the API and behavior stabilizes.
Full documentation: rekordbox-edit.readthedocs.io
Installation
pip install rekordbox-edit
Requirements:
- Python 3.11+
- FFmpeg (for audio conversion)
Quick Start
Search your library:
rbe search --artist "Daft Punk" --format flac
rbe search --playlist "House Favorites"
Edit track metadata:
# Fix a typo across every matching track title
rbe edit --title "Teh" Title --match "Teh" --replace "The"
Convert audio files:
# Preview what would be converted
rbe convert --artist "Daft Punk" --format-out aiff --dry-run
# Convert all FLAC or WAV files to AIFF without confirming
rbe convert --format flac --format wav --format-out aiff --yes
Import new tracks:
# Import a folder into the library and an existing playlist
rbe import "/Users/me/Music/New Tracks" --to-playlist "Recently Added" --yes
See the documentation for every command, the full filtering language, and scripting recipes.
Safety and Best Practices
Before using this tool:
-
Back up your Rekordbox database
Rekordbox already keeps multiple backups. But every time you close it, it creates a fresh one and deletes the oldest, so repetitive exits will quickly make those backups fairly useless.
You should make manual copies of RB's database backups before using this. You can usually find them in
~/Library/Pioneer/rekordbox/on macOS or%APPDATA%\Pioneer\rekordbox\on Windows. -
Back up your music library
If you don't have a back up already it's a very worthwhile investment, even if you don't plan to use this tool! Find yourself a cheap external drive, you won't regret it.
And more generally you should limit the potential impact of a mistake by using filters to target a few tracks at a time (e.g. --artist "Crazy Frog" --first 5) before targeting a larger set, and always run with --dry-run first.
Credits
This project exists thanks to @dylanjones, the creator of pyrekordbox, which provides the Python API for interacting with the Rekordbox database.
I built this tool to help correct my own bad habits and missteps in managing and organizing my Rekordbox library. If it helps you too, great! If you find issues or have ideas, contributions are welcome.
AI Usage
I believe it's important to be aware of and to disclose AI usage. The way its presence and usage is forced on us from every direction is too often gross and oppressive, and it's used almost exclusively for capitalist profit.
I'm mostly attempting to thoughtfully disclose that generative AI has been a significant tool in building out this project. I don't personally enjoy too much coding in my personal time, but I feel passionate about making rekordbox-edit--AI has admittedly helped me bridge that gap between my capacity and my goals of completing it. This being said, I'm a career professional software engineer who takes pride in their work, and I don't want to produce a vibe-coded mess any more than you want to experience it. Please validate the quality of this project yourself--at the end of the day it's just code written by a stranger on the internet!
p.s. If it's any consolation, my main test subject has been my own 10,000+ track RekordBox library--a risk I do not take lightly. :3
Contributing
See CONTRIBUTING.md for development setup, testing, and contribution guidelines.
1 maintainer
Release files for rekordbox-edit 0.12.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| rekordbox_edit-0.12.0.tar.gz | 7.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| rekordbox_edit-0.12.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 7.1 MB
Release files / rekordbox_edit-0.12.0.tar.gz
| Download URL | rekordbox_edit-0.12.0.tar.gz |
|---|---|
| Size | 7.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4d6b5372e56004cb94ccbebc201e7a3d38c9eed082a663bdc96b56237377862a
|
|
BLAKE2b-256 checksum How to use checksums |
ef0be667f9ece2362ab6c2d8c4a0e2b4e4332ca960fb01560346e48e30c958b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.
Transparency logRelease files / rekordbox_edit-0.12.0-py3-none-any.whl
| Download URL | rekordbox_edit-0.12.0-py3-none-any.whl |
|---|---|
| Size | 77.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
66b0e1cec722245646eb63a9a21f0ad5b63ddf778da8c1ebf6e77c5d8e90d63d
|
|
BLAKE2b-256 checksum How to use checksums |
23de7c09da4abeba1a7fc0d515a7b027d1fa6cb8e2702b7edffa183933a6f756
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.
Transparency log
