diff --git a/README.md b/README.md index badd932..015f53f 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,7 @@ It supports: - Real-time visual spectrum analyzer for listeners - Optional password protection for the DJ panel - Compatibility with reverse proxies like Cloudflare +- **Remote stream relay**: Relay live streams from other DJ servers to your listeners --- @@ -134,6 +135,17 @@ You should see output like: - Or download from URLs (paste into deck input / download controls) 4. Open the streaming panel and click **START BROADCAST** +### Remote Stream Relay + +TechDJ can relay live streams from other DJ servers: + +1. Open the DJ Panel: `http://localhost:5000` +2. Click the streaming panel (📡 LIVE STREAM) +3. In the "Remote Stream Relay" section, paste a remote stream URL (e.g., `http://remote.dj/stream.mp3`) +4. Click **START RELAY** +5. Your listeners will receive the relayed stream +6. Click **STOP RELAY** to end the relay + ### Listener workflow 1. Open the Listener Page: @@ -241,6 +253,14 @@ Example Cloudflare page rule: - Ensure the listener page is loaded and audio is enabled. - Check browser console for errors related to Web Audio API. + +### Remote relay not working + +- Ensure the remote stream URL is accessible and returns valid audio +- Check that `ffmpeg` is installed and can handle the remote stream format +- Verify the remote stream is MP3 or a format supported by ffmpeg +- Check server logs for ffmpeg errors when starting the relay + ### `pip` missing inside venv Some Python installs create venvs without pip. Fix: