Skip to content

v0.2.0 — M2: Desktop GUI + MilkDrop visualizer + one-click preset install

Choose a tag to compare

@ALunfb ALunfb released this 23 Apr 23:48
· 31 commits to main since this release

Major release. The companion graduates from headless tray → full Windows desktop app with a purple audio-producer UI, a real-time Butterchurn MilkDrop 2 visualizer driven by your system audio, and one-click installs of 1738 MIT-licensed presets from music.blackpearl.gg/visualizers.

Install

  1. Download tracklist-link.exe below.
  2. Double-click to run. A window + tray icon appear.
  3. From the tray → Pair dashboard, or copy the token manually from the Status tab.
  4. On the dashboard, paste it into OBS overlayReactive analyzer.
  5. Browse the preset gallery for more MilkDrop presets — click Install URL on any preset, paste into the companion's Presets tab → Install. It shows up in the Visualizer tab's dropdown immediately after a Rescan.

What's new since v0.1.0

Desktop GUI

  • Sidebar navigation: Status / Visualizer / Presets / Settings / About
  • Dark audio-producer theme (Ableton / FL / Reaper-inspired)
  • System tray unchanged — X-to-close hides to tray, right-click menu same as before plus new actions
  • Keyboard shortcuts in Visualizer: N/P/arrows for prev/next, R random, C auto-cycle, Space pause, F fullscreen, ? help

Butterchurn MilkDrop 2 visualizer

  • Ships with 50 bundled Cream-of-the-Crop presets
  • Driven by your real system audio, not a fake pulse — the WASAPI loopback FFT bridges directly into Butterchurn's render loop
  • Auto-cycle (30s default), search filter, random shuffle
  • Fullscreen ready for OBS Window Capture

Preset system

  • 1738 MIT-licensed presets hosted on music.blackpearl.gg/visualizers — search by name/author, filter, sort
  • One-click Install from URL in the Presets tab
  • Path-traversal + symlink guards on the Rust side; 5 MB preset cap; JSON parse validation
  • User presets merge with bundled in the Visualizer tab, marked with a prefix

Pairing

  • Tray → Pair dashboard opens the browser with your token pre-filled via URL fragment (never hits the server)
  • Dashboard auto-applies pairing + flashes a green banner

Plan docs added

Security

Unchanged from v0.1.0: binds 127.0.0.1 only, Origin allowlist, per-install 32-byte token, constant-time compared. MIT licensed. See SECURITY.md.

The internal UI uses Tauri IPC events for the audio data bridge (not the WS server), so the window never authenticates against the companion's own WS — that stays dedicated to external overlays.

Verify the binary

git clone https://github.com/ALunfb/tracklist-link.git
cd tracklist-link
git checkout v0.2.0
cd frontend && npm install && npm run build && cd ..
cargo build --release
sha256sum target/release/tracklist-link.exe

Compare the hash with the attached asset; open an issue if they differ.