Talk

I held a talk about LibreDJ at the Quellcode. I presented the project's idea & philosophy and how I'm using it to DJ/perform with.

Goals

• 4 Decks
• Good beat jumping/looping
• Good performance
• Low latency
• As best as possible playback/resampling
• Minimal & clean user interface
• Good library management
• Completely usable with Keyboard

Non-Goals

• No mixing/eq/effects. Use an external mixer or something like equis
• Session management. Use qpwgraph for this
• Radio Broadcasting
• Stem seperation (I'm up to support stem files though)
• Rekordbox/Serato export/import
  • If there's a good crate, maybe though

Supported Hardware

• Denon SC2000

How to run

Make sure you have pipewire/jack installed and a rust compiler.

- git clone the repo
- PIPEWIRE_QUANTUM=256 PLAYLISTS=/path/to/playlists LIBRARY=/path/to/your/music cargo run --release

Configuration

Supported environment variables:

• LIBRARY=/path/to/your/library Root path of library. LibreDJ will read from this directory.
• PLAYLIST=/path/to/your/playlists Path where playlists are loaded from (and saved to)
• HISTORY=/path/to/your/history If set, history.m3u will be saved here
• BINDING=fr_FR Set path from which a keyboard bindings file should get loaded
• SHOW_FPS=on|off Display FPS & frame time information in top bar

Keybindings

By default, the bindings are (for en_US keyboard) :

• Esc => Open Menu
• Arrow Keys => navigate library/file browser/popup
• Enter => Load track to current Deck
• F1-F4 => Switch between Deck 1-4
• q => Cue
• w => Play
• a s d f => Nudging
• z x c v => Adjusting Pitch
• i o p [ ] => Set loop starting at current playhead
• I O P { } => Set loop endingt at current playhead
• n m , . /- => Jump x beats forward
• N M < > ? => Jump x beats backwards
• Space => Switch waveform zoom
• - => Zoom out of Waveform
• = => Zoom in on Waveform
• F11 => Toggle fullscreen

To quit the program first press Esc, then q.

Customize Keybindings

The Keybindings are almost completely customizable. To do so, copy any existing binding to a new ron file (https://github.com/ron-rs/ron). Then select the keyboard binding file by setting the env variable BINDING.

- git clone the repo
- PIPEWIRE_QUANTUM=256 BINDING=/path/to/your/bindings.ron gui

Some alternatives layouts are provided in resources/keyboard_bindings. We currently support de_DE, fr_FR and en_US.

You can extend/alter the bindings map. Please have a look at the file and if you have questions feel free to ask.

Hacking

Hot Reloading

With the help of the subsecond crate of dioxus we can have hot reloading in the gui.

1. Make sure you configured your rustc to use the mold linker
2. Install dioxus cli with cargo install dioxus-cli --version <CURRENTSUBSECONDVERSIONSEECARGOTOML>
3. Wrap any code with crate::hotreload(|| { <YOURCODE> } ) to enable hot reloading for this code
4. Run the gui with dx Example: PIPEWIRE_QUANTUM=256 PLAYLIST=/home/foo/Musik/Techno/Playlists/ LIBRARY=/home/k/Musik/Techno HISTORY=/home/foo/Musik/Techno/Playlists/History pw-jack dx serve --hot-patch --features hotreload

Architecture

Screen Design for future GUI