From 12486543be88db6e072a3560786fe0777a825e9f Mon Sep 17 00:00:00 2001 From: Vynull App Date: Mon, 27 Jul 2026 20:14:17 +0000 Subject: [PATCH 1/2] docs: troubleshooting section The three problems people hit most (the CDJ waveform-color quirk, the post-upgrade re-analysis pass, and the rekordbox slot collision), plus how to collect useful logs for a bug report now that the default log level is quiet. About-the-project questions point at the website FAQ. --- README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/README.md b/README.md index 2df7fc0..9f214ed 100644 --- a/README.md +++ b/README.md @@ -735,6 +735,27 @@ DEVSETTING layout (6 bytes): `[unknown, overview_type, waveform_color, unknown, By default, all formats are served natively. FLAC/WAV/AIFF use the appropriate decoder ID in the track info response so the CDJ selects the correct decoder. Pass `--transcode` to convert lossless formats to MP3 if needed. +## Troubleshooting + +General questions about the project live at +[vynull.dev/#faq](https://vynull.dev/#faq). The three problems people hit +most: + +- **Blank scrolling waveform on the CDJ** — known deck quirk with network + sources: toggle the deck's waveform-color setting once and it renders from + then on. +- **Whole library re-analyzing after an upgrade** — expected, once per + release that improves the analysis (the cache version is bumped so existing + libraries get the improvements, not just new tracks). It runs in the + background as tracks are viewed or loaded. +- **CDJs silently stop loading tracks** — usually two rekordbox sources on + the network (real rekordbox running alongside Vynull); the log warns when + this collision is detected. Close one of them. + +For anything else, run with `--log-level debug` (or `trace` for wire-level +hex dumps) and attach the log to a bug report — the default level keeps logs +quiet, so debug logs say a lot more. + ## Acknowledgements This wouldn't exist without the people who reverse-engineered Pioneer's Pro DJ Link protocol and rekordbox's file formats and then published what they found. Most of what this project knows, it learned from their work: From 50172a7483828b2aa10634097401500143dd1e61 Mon Sep 17 00:00:00 2001 From: Vynull App Date: Mon, 27 Jul 2026 21:24:35 +0000 Subject: [PATCH 2/2] docs: lead the README with what the app does for hardware DJs The intro paragraph led with mechanism ("serves music files to CDJs over the Pro DJ Link protocol"); it now leads with the capability - load tracks from your PC straight onto CDJ/XDJ hardware with no rekordbox, no USB sticks, no export step - matching the framing of the website FAQ. Same facts, same length, mechanism and features follow. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9f214ed..a379f77 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ [![Go](https://img.shields.io/github/go-mod/go-version/vynulldev/vynull?color=ff7714)](go.mod) ![Platform](https://img.shields.io/badge/platform-linux%20x86--64%20%7C%20arm64-ff7714) -Vynull is a virtual CDJ / rekordbox source and library manager for Linux. It serves music files to CDJs (DJM mixers are also seen on the link) over the Pro DJ Link protocol. Point it at your music collection and CDJs see it as a connected USB drive or rekordbox instance. Includes a browser-based library manager and one-click import from your existing rekordbox or Traktor library. +Vynull is a DJ library application for Linux that interfaces directly with Pioneer CDJ/XDJ hardware: load tracks from your PC straight onto the decks over Pro DJ Link, with no rekordbox, no USB sticks, and no export step. Players see your machine as a connected rekordbox instance (or a CDJ-USB source) and browse and load your music with waveforms, beat grids, and cues; DJM mixers are tracked on the link too. Vynull analyzes tracks itself, includes a browser-based library manager, and imports your existing rekordbox or Traktor library in one click. ## Before you start