Features

• Multi-Deck Visualization — Up to 4 independent decks with crossfader mixing
• MilkDrop Presets — Full support for .milk and .prjm preset files via ProjectM 4.x
• Audio Capture — Native PipeWire/PulseAudio (Linux), WASAPI loopback (Windows)
• Video Output — v4l2loopback (Linux), Spout (Windows) for OBS/VLC integration
• NDI Streaming — Network video output (optional, requires NDI SDK)
• MIDI Control — Full MIDI mapping with learn mode and controller presets
• Playlist Management — Per-deck playlists with shuffle and auto-cycle
• Compositor — Blend modes (Normal, Add, Multiply, Screen, Overlay)
• Multi-Monitor — Fullscreen on any connected display
• Preset Browser — Favorites, categories, tags, progressive loading for large collections
• Theme Support — Dark/Light mode with 6 customizable accent colors
• VU Meters — Real-time audio level visualization

Download

Requirements

Linux

# Arch Linux
sudo pacman -S projectm pipewire

# Ubuntu/Debian
sudo apt install libprojectm4 pipewire

# Video output (optional)
sudo pacman -S v4l2loopback-dkms   # Arch
sudo modprobe v4l2loopback devices=1 video_nr=10 card_label="OpenDrop"

Windows

• Windows 10/11 (x64)
• GPU with OpenGL 3.3+ support
• Spout for video output to OBS (SpoutLibrary.dll bundled in installer)

Build from Source

# Prerequisites
# - Rust 1.75+
# - Node.js 18+
# - pnpm
# - libprojectM-4 development files

# Clone
git clone https://github.com/kushiemoon-dev/OpenDrop-VJ.git
cd OpenDrop-VJ

# Install dependencies
pnpm install

# Build renderer sidecar
cargo build --release -p opendrop-renderer
mkdir -p src-tauri/binaries
cp target/release/opendrop-renderer src-tauri/binaries/opendrop-renderer-$(rustc -vV | grep host | cut -d' ' -f2)

# Development mode
pnpm tauri dev

# Release build
pnpm tauri build

Architecture

┌─────────────────────────────────────────────────────────┐
│         Frontend (Svelte 5 / SvelteKit)                 │
│  PresetBrowser, Playlist, Crossfader, MIDI, VU Meters  │
└────────────────┬────────────────────────────────────────┘
                 │ Tauri IPC Commands
                 ▼
┌─────────────────────────────────────────────────────────┐
│         Tauri Backend (Rust)                            │
│  AppState, AudioEngine, MIDI, Crossfader, Compositor   │
└──┬──────────────────────────────────────────────┬───────┘
   │ Spawn (JSON IPC)                             │ Audio
   ▼                                              ▼
┌──────────────────┐  ┌──────────────────┐   ┌──────────┐
│ Renderer Deck 0  │  │ Renderer Deck 1-3│   │ PipeWire │
│ ProjectM+OpenGL  │  │ ProjectM+OpenGL  │   │ /WASAPI  │
│ + Video Output   │  │ + Video Output   │   └──────────┘
└────────┬─────────┘  └──────────────────┘
         │ glReadPixels
         ▼
┌──────────────────┐
│ v4l2 / Spout     │ → OBS / VLC
│ / NDI            │
└──────────────────┘

Video Output Setup

Linux (v4l2loopback)

# Load kernel module
sudo modprobe v4l2loopback devices=1 video_nr=10 card_label="OpenDrop"

# Verify device
ls -la /dev/video10

# In OBS: Sources → Video Capture Device → OpenDrop

Windows (Spout)

SpoutLibrary.dll is bundled with the installer. In OBS:

1. Install the Spout2 plugin for OBS
2. Sources → Spout2 Capture → Select "OpenDrop Deck 1"

MIDI Controller Support

Built-in presets for popular controllers:

• Generic DJ — Universal 2-deck mapping
• Akai APC Mini — Grid-based control
• Novation Launchpad — Pad-based preset switching
• Korg nanoKONTROL2 — Fader-based mixing

Custom mappings can be created via the MIDI Learn mode.

Configuration

Settings are stored in:

• Linux: ~/.config/opendrop/
• Windows: %APPDATA%\OpenDrop\

Preset and texture directories are configurable in Settings (gear icon).

Tech Stack

Project Structure

OpenDrop-VJ/
├── src/                    # Svelte frontend
│   ├── lib/components/     # UI components (12)
│   ├── lib/stores/         # State management (Svelte 5 runes)
│   └── routes/             # SvelteKit pages
├── src-tauri/              # Tauri backend
│   └── src/lib.rs          # Main Rust logic
├── crates/
│   ├── opendrop-core/      # Core library (audio, video, MIDI)
│   ├── opendrop-renderer/  # OpenGL renderer process (sidecar)
│   ├── projectm-rs/        # Safe ProjectM wrapper
│   └── projectm-sys/       # ProjectM FFI bindings
└── assets/                 # Bundled presets & textures

Credits

• ProjectM — MilkDrop visualization engine
• Tauri — Desktop application framework
• Svelte — Frontend framework
• Spout2 — Video frame sharing (Windows)
• midir — MIDI library for Rust
• Lucide — Icon library

Disclaimer

• This software is for personal and educational use only
• Respect the licenses of preset files you use
• Support the original preset creators
• No warranty is provided; use at your own risk

License

MIT License - See LICENSE for details.