- Rust 63.9%
- Svelte 26%
- TypeScript 8.8%
- CSS 0.7%
- Kotlin 0.6%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
- crates/sync: Ops pro Feld (neueste Änderung gewinnt), Zusammenführen gleicher Aufnahmen über kanonische uid + Alias, Platzhalter für Tracks anderer Geräte, Test-Server im Speicher; Trigger schweigen, während Remote-Änderungen angewendet werden - Android: USB-Plugin blockiert den App-Start nicht mehr; Startprotokoll ist ohne App-Zustand abrufbar und erscheint bei Problemen; keine Fensterknöpfe auf Mobilgeräten - CI: package.json im Wurzelverzeichnis wieder entfernt (brach die Desktop-Builds), Tauri-CLI im Android-Job über den absoluten Pfad Refs #14 #26 #28 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014gdRpof5rE8kXfnyZ2MxKf |
||
| .github/workflows | ||
| assets | ||
| crates | ||
| docs | ||
| resources/rekordbox | ||
| src-tauri | ||
| ui | ||
| vendor | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| README.md | ||
USB-Sticks für Denon/Engine DJ und Pioneer/rekordbox aus einer einzigen Musikbibliothek.
Für macOS, Windows und Linux · Open Source (MPL-2.0)
⬇ Download · Funktionen · Screenshots · Installation · Entwickeln
Warum EngineBox?
Im Club steht mal ein Denon-Setup, mal Pioneer. Deine Freunde legen mit rekordbox auf, du vielleicht mit Engine DJ. EngineBox hält eine Bibliothek mit Playlists, Hot Cues, Loops und Beatgrids und schreibt daraus Sticks, die auf beiden Systemen gleichzeitig laufen. Die Musik liegt dabei nur einmal auf dem Stick.
- 🎛️ Ein Stick für alle Player: Engine DJ (Denon DJ, Numark, RANE) und rekordbox (CDJ, XDJ, Opus Quad, OMNIS, auch OneLibrary für CDJ-3000X/XDJ-AZ)
- 🔁 Zurück in die Bibliothek: Am Player gesetzte Cues, Loops und korrigierte Beatgrids kommen beim nächsten Sync zurück
- 🤝 Mit der rekordbox-Welt tauschen: Bibliotheken aus rekordbox, rekordbox-XML, Engine DJ und von fremden Sticks importieren
- 🧠 Eigene Analyse: BPM, Beatgrid mit Taktanfang, Tonart, Energie und 3-Band-Waveform, parallel und schnell
- 🧰 Bibliothekspflege: Smart-Playlists, Duplikate, verschobene Dateien wiederfinden, Suchen & Ersetzen
- 🎧 Vorbereiten wie am Player: Deck mit Hot Cues, Loops, Tempo, Key Lock und passenden Tracks fürs nächste Set
Screenshots
![]() Vorbereiten: Cues, Loops, Beatgrid, Tempo und Key Lock. Links Tracks, die harmonisch und im Tempo passen. |
![]() Sticks: Playlists wählen, Formate an, synchronisieren. Nur Neues wird kopiert. |
![]() Importieren: rekordbox-Datenbank, XML, Engine DJ oder Stick, mit Cues und Grids. |
![]() Smart-Playlists: Regeln über Genre, BPM, Tonart, Energie, Rating … landen als normale Playlist auf dem Stick. |
![]() Duplikate: Erkennung über das Audio selbst, Zusammenführen ohne Playlists oder Cues zu verlieren. |
So funktioniert's
|
Kompatibilität
| Engine DJ | rekordbox (Device Library) | rekordbox (OneLibrary) | |
|---|---|---|---|
| Player | Denon DJ Prime/SC, Numark, RANE (Engine OS) | CDJ-2000NXS2, CDJ-3000, XDJ, Opus Quad … | CDJ-3000X, XDJ-AZ, OMNIS-DUO, CDJ-3000 ab FW 3.30 |
| Playlists & Ordner | ✅ | ✅ | ✅ |
| Hot Cues, Memory Cues, Loops | ✅ | ✅ | ✅ |
| Beatgrid & Waveform | ✅ | ✅ | ✅ |
| Cover | ✅ | ✅ | ✅ |
| Änderungen vom Player zurückholen | ✅ Cues, Loops, Grids | ✅ Cues, Loops | ✅ Cues, Loops |
| Import von fremden Sticks | ✅ | ✅ | ✅ |
Engine-DJ-Datenbanken von Version 4.0 bis 4.5/5.x. Getestet wird bisher auf einem Denon SC Live 4; Rückmeldungen
von anderer Hardware sind sehr willkommen (Checkliste: docs/HARDWARE-TEST.md).
Installation
Fertige Pakete gibt es unter Releases:
| System | Datei | Hinweis |
|---|---|---|
| macOS (Apple Silicon & Intel) | EngineBox_x.y.z_universal.dmg |
Nicht signiert: beim ersten Start Rechtsklick › Öffnen, oder xattr -dr com.apple.quarantine /Applications/EngineBox.app |
| Linux (x86_64) | EngineBox_x.y.z_amd64.AppImage |
chmod +x und starten |
| Windows | EngineBox_x.y.z_x64-setup.exe / .msi |
ab dem nächsten Release (Build-Runner läuft) |
| Android (Vorschau) | android-preview |
Testbuild (Debug, arm64), noch kein vollwertiger Stick-Sync – siehe #26 |
EngineBox prüft beim Start, ob es eine neuere Version gibt (es werden dabei keine Daten gesendet); die installierte Version steht rechts oben in der Titelleiste.
Funktionen
Die App ist in Workbenches gegliedert (Tabs in der Titelleiste): Bibliothek (Tracks, Playlists, Import), Vorbereiten (großes Deck zum Setzen von Cues, Loops, Beatgrid, Tempo), Sticks (Sync und Import vom Stick), Werkzeuge (Import, Duplikate, fehlende Dateien, Sammel-Bearbeitung) und Info (installierte Version, Update-Prüfung gegen die Releases auf forge.voidborn.xyz – es werden dabei keine Daten gesendet).
- Bibliothek: Ordner/Dateien importieren (auch per Drag & Drop), Tags lesen (MP3, M4A/AAC/ALAC, FLAC, WAV, AIFF, OGG), BPM/Key aus Tags (Camelot, Open Key und klassische Notation), schnelle virtualisierte Tabelle mit Suche und Sortierung, Rating, Track-Farben, Infos bearbeiten.
- Analyse: BPM-Erkennung, Beatgrid (inkl. Taktanfang), Tonart-Erkennung (Camelot) und 3-Band-Waveform für jeden Track – parallel, ca. 0,7 s pro 6-Minuten-Track. BPM/Key aus den Tags haben Vorrang, die Analyse füllt Lücken. Das Genre-Tag lenkt den BPM-Bereich (z. B. Drum & Bass 155–195, Hip-Hop 60–120), damit halbe/doppelte Tempi vermieden werden. Läuft automatisch nach dem Import und vor dem Sync für noch nicht analysierte Tracks; Waveform-Vorschau im Track-Panel.
- Player: Vorhören direkt in der App (Doppelklick, Leertaste), Waveform mit Beatgrid als Suchleiste, vor/zurück durch die aktuelle Liste.
- Deck (im Player-Balken aufklappbar oder als Workbench „Vorbereiten“): Detail-Waveform mit Beat- und Taktlinien (Zoom per Mausrad), Loops über 1–32 Beats (sample-genau, als Hot Loop speicherbar, Taste L), Beatgrid korrigieren (verschieben, „Beat hier“, „Takt 1 hier“, BPM eintippen, ×2/÷2) – Korrekturen bleiben bei neuer Analyse erhalten und gehen in alle Exporte.
- Tempo: Tempo-Fader (±8/±16/±50 %), Ziel-BPM eintippen, Pitch Bend, Key Lock (Tonhöhe bleibt, Signalsmith Stretch) und Tonart-Verschiebung in Halbtönen; BPM und Tonart in der Leiste zeigen den aktuellen Wert.
- Cue Points: 8 Hot Cues (Pads A–H oder Tasten 1–8, optional auf den Beat quantisiert), Memory Cues, Name und Farbe – werden nach Engine DJ, rekordbox (ANLZ) und OneLibrary exportiert (experimentell, noch nicht auf Hardware geprüft).
- Playlists & Ordner: verschachtelt, per Drag & Drop sortieren/verschieben, Tracks hineinziehen, Reihenfolge per Drag ändern.
- Smart-Playlists: Regeln über Genre, Interpret, BPM, Tonart (auch „passt harmonisch zu“), Energie, Rating, Jahr, Hinzugefügt, „in keiner Playlist“, „hat Cues“ usw., mit Sortierung und Limit. Der Inhalt wird bei jedem Öffnen und Sync neu berechnet und landet auf dem Stick als normale Playlist.
- Energie & passende Tracks: Die Analyse bewertet jeden Track mit einer Energie von 1–10 (Lautheit, Tempo, Helligkeit, Dichte – eine Heuristik). „Passt dazu“ im Track-Panel und der Reiter „Passend“ in Vorbereiten zeigen Tracks, die harmonisch (Camelot-Rad), im Tempo (inkl. halbes/doppeltes Tempo) und in der Energie passen.
- Werkzeuge (Workbench):
- Importieren aus rekordbox (direkt aus der rekordbox-6/7-Datenbank auf Mac/Windows oder aus einer rekordbox-XML), aus Engine DJ Desktop und von USB-Sticks beider Systeme (
export.pdb, OneLibrary, Engine) – mit Playlists, Hot/Memory Cues, Loops und Beatgrids. Tracks ohne Datei (z. B. XML von einem anderen Computer) können als „fehlend“ übernommen und danach wiedergefunden werden. - Duplikate über einen Audio-Fingerabdruck (identisches Audio trotz anderer Tags/Dateinamen) oder gleichen Interpret/Titel/Länge; beim Zusammenführen wandern Playlists, Cues, Grid und Rating zum behaltenen Track.
- Fehlende Dateien in anderen Ordnern wiederfinden (Name, Größe, Länge, Tags), ohne Cues und Playlists zu verlieren.
- Suchen & Ersetzen in Track-Infos mit Vorschau; Cue-Sammelaktionen (Memory Cues aus Hot Cues, Hot → Memory, Farben pro Pad); Tonart-Anzeige als Camelot, Open Key oder klassisch.
- Importieren aus rekordbox (direkt aus der rekordbox-6/7-Datenbank auf Mac/Windows oder aus einer rekordbox-XML), aus Engine DJ Desktop und von USB-Sticks beider Systeme (
- USB-Sync
- Engine DJ:
Engine Library/Database2/m.db, wählbar für Engine DJ 4.0 bis 4.5/5.x (Schema 2.21.2 / 3.0.0 / 3.0.1 / 3.0.2). - rekordbox: beide Formate wie rekordbox 7 –
PIONEER/rekordbox/export.pdb(Device Library, ältere CDJ/XDJ) undexportLibrary.db(OneLibrary, verschlüsselt; CDJ-3000X, XDJ-AZ, OPUS-QUAD, OMNIS-DUO), plus AnalysedateienPIONEER/USBANLZ/…/ANLZ0000.DAT/.EXT(Beatgrid, Waveform-Vorschau, Detail- und Farb-Waveform). - Engine DJ: Beatgrid, Übersichts-Waveform und Track-Daten als
PerformanceData– Tracks gelten auf dem Player als analysiert. - Cover: eingebettete Cover oder
cover.jpg/folder.jpgneben der Datei, für beide Systeme skaliert (rekordbox 80/240 px, Engine 240 px); gleiche Cover werden nur einmal gespeichert. - Inkrementell: nur neue/geänderte Dateien werden kopiert, nicht mehr benötigte werden (optional) gelöscht.
- Ganze Bibliothek oder ausgewählte Playlists/Ordner pro Stick; die Auswahl wird pro Stick gemerkt.
- Platzprüfung, Dateisystem-Warnung (NTFS/APFS/ext4 werden von Playern nicht gelesen), Abbrechen jederzeit möglich.
- Engine DJ:
Aufbau
crates/core Rust: Bibliothek (SQLite), Tag-Scanner, Engine-/rekordbox-Export, Sync
vendor/rekordcrate rekordcrate (MPL-2.0) + EngineBox-PDB-Writer (src/pdb/builder.rs)
vendor/signalsmith-stretch Signalsmith Stretch (MIT) für Key Lock, FFI ohne bindgen
src-tauri Tauri-2-Shell, Befehle für das UI
ui Svelte-5-Oberfläche (läuft mit `npm run dev` auch im Browser mit Mock-Daten)
Layout auf dem Stick:
/Contents/<Interpret>/<Album>/<Datei> Audiodateien (gemeinsam genutzt)
/Engine Library/Database2/m.db Engine DJ
/PIONEER/rekordbox/export.pdb rekordbox
/.enginebox/manifest.json Buchführung für inkrementelle Syncs
Entwickeln
Voraussetzungen: Rust (stable), Node 20+, plus unter Linux:
sudo apt-get install build-essential pkg-config libwebkit2gtk-4.1-dev libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev libasound2-dev
npm ci --prefix ui
./ui/node_modules/.bin/tauri dev # App mit Hot Reload (vom Projekt-Root aus)
./ui/node_modules/.bin/tauri build # Installer für das aktuelle OS (Linux: AppImage + .deb)
cargo test -p enginebox-core # Tests (Engine-DB, PDB-Roundtrip, Ende-zu-Ende-Sync)
npm --prefix ui run dev # nur UI im Browser (Mock-Backend)
Kommandozeile für Tests/Skripte:
cargo run -p enginebox-core --example cli -- lib.db import ~/Music
cargo run -p enginebox-core --example cli -- lib.db analyze
cargo run -p enginebox-core --example cli -- lib.db sync /media/USBSTICK
cargo run -p enginebox-core --example dump_pdb -- /media/USBSTICK/PIONEER/rekordbox/export.pdb
Installer für macOS (Universal), Windows und Linux baut der Workflow in .github/workflows/build.yml (Forgejo Actions: Tests und Linux-AppImage laufen auf dem eigenen Runner, macOS/Windows folgen, sobald deren Runner bereitstehen).
Bekannte Grenzen / Roadmap
Offene Tests, Features und Ideen werden als Issues gepflegt (Labels Hardware-Test, Test, Feature, Idee, Cloud; Meilensteine Hardware-Tests 0.9 und Cloud-Sync).
-
Cloud: geplant ist ein eigener Sync-Dienst, damit mehrere Rechner (und später Sticks/Geräte) eine Bibliothek teilen.
-
Player: eigene Audio-Engine (Rust: symphonia + cpal) – spielt alle Formate, die auch analysiert werden, unabhängig vom Webview. Mit Tempo und Key Lock; ein Deck. Geplant: zweites Deck, Sync, Mixer für den Einsatz als kleines DJ-Tool.
-
Analyse-Grenzen: Beatgrids haben ein konstantes Tempo (passt für die meiste elektronische Musik, nicht für Live-Aufnahmen mit schwankendem Tempo). Die VBR-Sprungtabelle (
PVBR) wird wie bei CBR-Dateien geschrieben – bei VBR-MP3s kann das Springen auf Pioneer-Playern ungenau sein. Keine Engine-High-Res-Waveform (der Player erzeugt sie bei Bedarf), keine rekordbox-.2EX-Dateien (3-Band-Waveform der neuesten Player). -
Player-Änderungen: Am Player gesetzte Hot Cues, Memory Cues und Loops (Engine, CDJ/XDJ über die Analysedateien, OneLibrary-Player über
exportLibrary.db) und am Engine-Player korrigierte Beatgrids werden beim nächsten Sync in die EngineBox-Bibliothek übernommen (abschaltbar) und landen so auch auf anderen Sticks und im rekordbox-Export. Erkannt wird das über einen Fingerabdruck pro Track: nur was sich seit dem letzten Sync am Player geändert hat, wird übernommen; danach in EngineBox Geändertes gewinnt. Engine kennt nur einen Memory Cue (den Main Cue) – weitere Memory Cues aus EngineBox bleiben erhalten. rekordbox speichert die komplette Cue-Liste, deshalb ersetzt eine Änderung dort die Cues des Tracks. Play-Status (Engine) sowie History (rekordbox) bleiben auf dem Stick erhalten. Am CDJ korrigierte Beatgrids werden noch nicht übernommen. -
rekordbox-Datenbank: der direkte Import aus
master.dbfolgt dem von pyrekordbox dokumentierten Format und ist nur synthetisch getestet; bei Problemen den XML-Export nutzen. Smart-Playlists aus der rekordbox-Datenbank werden in EngineBox-Regeln übersetzt; Bedingungen ohne Gegenstück (My Tag, Play Count, Erscheinungsdatum, Mix-Name, Original-Interpret) fallen weg. -
Sync-Vorbereitung: Tracks und Playlists haben geräteübergreifende IDs (
uid); ein Änderungsprotokoll (Tabellechanges, per SQLite-Trigger) hält jede Änderung an Track-Feldern, Cues, Beatgrids und Playlists mit Zeitpunkt und Geräte-ID fest, Löschungen zusätzlich indeleted. Gerätespezifisches (Dateipfade, Analyse-Caches) wird nicht protokolliert – Grundlage für den geplanten Cloud-Sync. -
Getestet gegen die Format-Spezifikationen und Parser (rekordcrate, libdjinterop-Schema). Tests auf echter Hardware stehen noch aus – Checkliste:
docs/HARDWARE-TEST.md.
Branding
Logo und Banner liegen unter docs/branding/ (SVG und PNG). Farben: Akzent #ff7a45 → #ff3d77, Sekundär #2ee6c5 → #3d8bff, Hintergrund #0b0d12.
Lizenz
MPL-2.0. Enthält rekordcrate (MPL-2.0), Signalsmith Stretch (MIT) und aus libdjinterop (LGPL-3.0) extrahierte Schema-Definitionen, siehe crates/core/resources/engine/README.md.




