Update README with remote stream relay feature documentation

- Added remote stream relay to features list
- Added usage instructions for remote relay
- Added troubleshooting section for relay issues
This commit is contained in:
3nd3r
2026-01-03 10:30:40 -06:00
parent 81120ac7ea
commit e4f27c012d

View File

@@ -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: