From eda1c52ae71240f2fbd72c17b793e62059138159 Mon Sep 17 00:00:00 2001 From: Vynull App Date: Wed, 22 Jul 2026 21:25:48 +0000 Subject: [PATCH] docs: drop sudo from rekordbox-mode run commands rekordbox mode (the default) binds only unprivileged ports - the deck queries Pioneer's non-standard portmapper on 50111, and the README's own "Port 111 (CDJ mode only)" section says as much - but the Web UI and Directory Mode examples and the Makefile run target all started with sudo anyway, teaching every new user to run the whole app as root for nothing. The Makefile even said "no privileged ports needed" one line above the sudo. Only --mode cdj needs UDP 111; that example keeps sudo with a comment pointing at the sudo-free options (sysctl / setcap / iptables). --- Makefile | 2 +- README.md | 5 +++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/Makefile b/Makefile index 6e8b2fc..fefd850 100644 --- a/Makefile +++ b/Makefile @@ -6,7 +6,7 @@ build: # rekordbox mode (the default) — no privileged ports needed run: build - sudo ./vynull --music-dir $(MUSIC) + ./vynull --music-dir $(MUSIC) # CDJ-USB source mode — needs UDP 111 (see README Requirements) run-cdj: build diff --git a/README.md b/README.md index 3caf3c2..2df7fc0 100644 --- a/README.md +++ b/README.md @@ -128,7 +128,7 @@ By default it listens on `127.0.0.1:9443`; use `--listen 0.0.0.0:9443` to reach it from another device on the LAN. ```bash -sudo ./vynull --interface eth1 --mode rekordbox --web --listen 0.0.0.0:9443 +./vynull --interface eth1 --mode rekordbox --web --listen 0.0.0.0:9443 # then open http://:9443/ ``` @@ -173,7 +173,7 @@ else need no Python. Scan a music directory at startup: ```bash -sudo ./vynull --interface eth1 --music-dir /path/to/music --lazy-analysis +./vynull --interface eth1 --music-dir /path/to/music --lazy-analysis ``` ### Rekordbox USB Mode @@ -181,6 +181,7 @@ sudo ./vynull --interface eth1 --music-dir /path/to/music --lazy-analysis If you have an existing rekordbox-exported USB drive: ```bash +# CDJ mode needs UDP 111 — see "Port 111 (CDJ mode only)" for sudo-free options sudo ./vynull --interface eth1 --music-dir /media/usb --mode cdj ```