Remove deprecated files and scripts to streamline the codebase
- Deleted unused API test files, RTSP diagnostic scripts, and development utility scripts to reduce clutter. - Removed outdated database schema and modularization proposal documents to maintain focus on current architecture. - Cleaned up configuration files and logging scripts that are no longer in use, enhancing project maintainability.
This commit is contained in:
72
docs/rtsp_access_guide.md
Normal file
72
docs/rtsp_access_guide.md
Normal file
@@ -0,0 +1,72 @@
|
||||
# RTSP Streaming Access Guide (Tailscale)
|
||||
|
||||
## Your Tailscale IP
|
||||
**100.93.40.84**
|
||||
|
||||
## Access URLs
|
||||
|
||||
Replace `exp-dash` with `100.93.40.84` in all URLs when accessing from outside the VM.
|
||||
|
||||
### 1. MediaMTX Web Interface (Best for Testing)
|
||||
```
|
||||
http://100.93.40.84:8889/static/
|
||||
```
|
||||
This shows all available streams with a built-in player.
|
||||
|
||||
### 2. Direct WebRTC Player for Camera1
|
||||
```
|
||||
http://100.93.40.84:8889/camera1/webrtc
|
||||
```
|
||||
This is a browser-based player that works without VLC.
|
||||
|
||||
### 3. RTSP URL (for VLC/ffplay)
|
||||
```
|
||||
rtsp://100.93.40.84:8554/camera1
|
||||
```
|
||||
|
||||
**For VLC:**
|
||||
- File → Open Network Stream
|
||||
- URL: `rtsp://100.93.40.84:8554/camera1`
|
||||
- Or use: `rtsp://100.93.40.84:8554/camera1?transport=tcp`
|
||||
|
||||
**For ffplay:**
|
||||
```bash
|
||||
ffplay -rtsp_transport tcp rtsp://100.93.40.84:8554/camera1
|
||||
```
|
||||
|
||||
## Important Notes
|
||||
|
||||
1. **Stream Timeout**: MediaMTX closes streams after ~10 seconds if no one is watching. Make sure to:
|
||||
- Start RTSP first: `curl -X POST http://exp-dash:8000/cameras/camera1/start-rtsp`
|
||||
- Then quickly open the viewer within 10 seconds
|
||||
|
||||
2. **Ports Exposed**:
|
||||
- 8554: RTSP
|
||||
- 8889: WebRTC/HTTP API
|
||||
- 8189: WebRTC UDP
|
||||
|
||||
3. **Network**: Tailscale creates a VPN, so you can access these URLs from anywhere, as long as your client device is also on the same Tailscale network.
|
||||
|
||||
## Testing Steps
|
||||
|
||||
1. **Start the stream:**
|
||||
```bash
|
||||
curl -X POST http://exp-dash:8000/cameras/camera1/start-rtsp
|
||||
```
|
||||
|
||||
2. **Quickly open a viewer** (within 10 seconds):
|
||||
- Open browser: `http://100.93.40.84:8889/static/`
|
||||
- Or: `http://100.93.40.84:8889/camera1/webrtc`
|
||||
|
||||
3. **Check status:**
|
||||
```bash
|
||||
./check_rtsp_status.sh
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
If you see "no stream is available":
|
||||
- The stream might have timed out (waited >10 seconds without viewer)
|
||||
- Restart the stream and quickly connect
|
||||
- Check logs: `docker compose logs api --tail 20 | grep RTSP`
|
||||
|
||||
Reference in New Issue
Block a user