Live Streaming Troubleshooting
Having trouble with your live stream? This guide covers common issues and solutions for webcam.io streaming to YouTube, Twitch, and Facebook.
Quick Diagnosis
Check Your Dashboard First
Go to webcam.io Dashboard and look at your webcam’s status:
| Status | Meaning | Action |
|---|---|---|
| 🟢 OK | Connected, sending data | Check destination (YouTube/Twitch) |
| 🔄 Restarting | Reconnecting | Wait 1-2 min, then investigate |
| 🔴 Error | Failed to connect | Check input URL and credentials |
| ⚪ Stopped | Streaming disabled | Enable streaming in settings |
The 3 Connection Points
Live streaming has three connection points. Identify where the problem is:
[Your Camera] ──→ [webcam.io] ──→ [YouTube/Twitch/Facebook]
(1) (2) (3)
| Point | Test | Common Issues |
|---|---|---|
| (1) Camera → webcam.io | Dashboard shows “Restarting” | Port forwarding, camera offline, wrong URL |
| (2) webcam.io processing | Dashboard shows errors | Transcoding issues, plan limits |
| (3) webcam.io → Platform | Dashboard “Streaming” but platform offline | Wrong stream key, platform settings |
Connection Problems
Stream Shows “Restarting” Continuously
Symptom: Dashboard shows repeated “restarting” entries in the status log.
Causes and Solutions:
| Cause | Solution |
|---|---|
| Camera not accessible | Test RTSP URL with VLC from outside your network |
| Wrong camera URL | Verify URL format for your camera model |
| Port forwarding broken | Check router settings, test with port checker |
| Camera requires auth | Include username:password in URL |
| Firewall blocking | Allow webcam.io IPs (see Static IPs) |
| Camera overloaded | Reduce concurrent connections to camera |
How to test your camera URL:
- Find your external IP: whatismyip.com
- Open VLC → File → Open Network
- Enter:
rtsp://YOUR-EXTERNAL-IP:554/your/camera/path - If it doesn’t play, the camera isn’t accessible from outside
“Input format not recognized”
Symptom: Stream fails immediately with format error.
Solutions:
| Camera Type | Solution |
|---|---|
| H.264/RTSP | Should work — verify URL is correct |
| MJPEG | Enable transcoding, requires LIVE+ plan |
| Mobotix MxPEG | Enable transcoding, requires LIVE+ plan |
| H.265/HEVC | Enable transcoding, requires LIVE+ plan |
Camera Works Locally but Not Remotely
Checklist:
Test port forwarding:
Use portchecker.co to verify your port is open.
YouTube-Specific Issues
Stream Shows “Offline” in YouTube (but webcam.io says “OK”)
Cause: YouTube’s “Stream Tab” doesn’t auto-reconnect after interruptions.
Solution: Use Scheduled Streams instead:
- Go to YouTube Studio → Live → Manage tab
- Click Schedule Stream
- Configure and create
- Use the new Stream Key in webcam.io
The default YouTube “Stream Tab” (Go Live button) is problematic for 24/7 streaming. Always use Scheduled Streams.
Stream Ended and Won’t Restart
Cause: YouTube ended the scheduled stream (happens after extended inactivity or issues).
Solution:
- Go to YouTube Live → Manage tab
- Your stream may show as “Ended”
- Create a new Scheduled Stream
- Select Reuse settings from previous stream
- Update stream key in webcam.io if changed
YouTube Shows “No Data” Despite Streaming
| Check | Solution |
|---|---|
| Stream Key correct? | Copy fresh from YouTube, paste in webcam.io |
| Output URL format? | Must be rtmp://a.rtmp.youtube.com/live2/STREAM-KEY |
| Scheduled stream active? | Must be “Waiting for data”, not “Ended” |
| Camera sending data? | Check webcam.io dashboard for bitrate |
Duplicate Content Warnings from YouTube
Cause: YouTube auto-archives your live streams as videos.
Solutions:
- Enable Auto-Delete in webcam.io (see YouTube Guide)
- Manually delete archives in YouTube Studio
- Set stream to Unlisted to reduce detection
Can’t Embed YouTube Live Stream
Requirements checklist:
Alternative: If embedding issues persist, try Twitch — much easier to embed.
Twitch-Specific Issues
Stream Not Appearing on Twitch
| Check | Solution |
|---|---|
| Stream Key correct? | Copy fresh from Twitch settings |
| Ingest server? | Use server close to webcam.io (Frankfurt: live-fra02.twitch.tv) |
| Output URL format? | Must be rtmp://SERVER/app/STREAM-KEY |
Twitch Embed Not Working
Common cause: Missing or wrong parent parameter.
<!-- WRONG - missing parent -->
<iframe src="https://player.twitch.tv/?channel=mychannel"></iframe>
<!-- CORRECT - with parent -->
<iframe src="https://player.twitch.tv/?channel=mychannel&parent=yourdomain.com"></iframe>The parent must match your website’s domain exactly.
Disconnection Protection Not Working
Ensure Disconnect Protection is enabled:
- Twitch → Settings → Channel and Videos
- Enable Disconnect Protection
Also enable Backup Stream in webcam.io for additional reliability.
Facebook-Specific Issues
Stream Ended Unexpectedly
Cause: Facebook ended the live video (common without proper setup).
Prevention:
- Enable Continuous Live Video in Facebook stream settings → Advanced
- Enable Backup Stream in webcam.io
- Never click Finish in Facebook (use Save instead)
To restart:
- Create a new Live Video post
- Get the new Stream Key
- Update webcam.io Output URL
Can’t Find Embed Code
Problem: Embed code only available before going live.
Solution: For future streams, copy embed code before clicking Save.
Workaround: Use the Facebook Page Plugin instead, or switch to YouTube/Twitch.
Multiple “Restarting” After Stream Ended
Cause: Facebook rejected the stream, webcam.io keeps retrying.
Solution:
- Create new Live Video post in Facebook
- Get new Stream Key
- Update webcam.io immediately
Video Quality Issues
Pixelated or Blocky Video
| Cause | Solution |
|---|---|
| Low camera bitrate | Increase bitrate in camera settings |
| Transcoding too aggressive | Use higher quality preset |
| Network congestion | Ensure stable upload bandwidth |
| Camera resolution too low | Use higher resolution setting |
Recommended bitrates:
| Resolution | Minimum Bitrate | Recommended |
|---|---|---|
| 720p | 1,500 kbps | 2,500 kbps |
| 1080p | 3,000 kbps | 4,500 kbps |
| 1080p60 | 4,500 kbps | 6,000 kbps |
Choppy or Stuttering Playback
| Cause | Solution |
|---|---|
| Insufficient upload bandwidth | Need 1.5× your bitrate as upload speed |
| Camera frame rate issues | Reduce to 15 or 20 fps |
| Transcoding overload | Contact support for server adjustment |
| Viewer’s connection | Not your problem — they need better internet |
Test your upload speed: speedtest.net
High Latency (Delay)
All live streams have some delay. Typical values:
| Platform | Setting | Delay |
|---|---|---|
| YouTube | Ultra-low latency | 3-5 sec |
| YouTube | Low latency | 8-15 sec |
| YouTube | Normal | 15-30 sec |
| Twitch | Low latency | 2-5 sec |
| Twitch | Normal | 5-10 sec |
Note: Lower latency = less stable. For 24/7 webcams, use Normal latency.
Dark or Overexposed Image
This is a camera issue, not streaming:
- Access your camera’s web interface
- Adjust exposure/brightness settings
- Enable auto-exposure if available
- Check for backlight compensation
Transcoding Issues
“Transcoding required” Error
Cause: Your camera codec isn’t directly supported by the streaming platform.
| Camera Output | Solution |
|---|---|
| H.264 | No transcoding needed (LIVE plan) |
| MJPEG | Enable transcoding (LIVE+ plan required) |
| MxPEG (Mobotix) | Enable transcoding (LIVE+ plan required) |
| H.265/HEVC | Enable transcoding (LIVE+ plan required) |
Transcoding Uses Too Much Bandwidth
Solution: Choose a lower transcoding preset:
| Preset | Use When |
|---|---|
| 720p / 5 fps | Very low bandwidth, simple scenes |
| 720p / 15 fps | Standard quality (recommended) |
| 1080p / 15 fps | High quality, good bandwidth |
| 1080p / 30 fps | Maximum quality |
Audio Issues with Transcoding
If your camera has audio and it’s not working after transcoding:
- Verify camera is sending audio in the stream
- Check platform supports audio (all major ones do)
- Contact support — may need server-side adjustment
Platform Connection Issues
“Invalid stream key” Error
| Platform | Solution |
|---|---|
| YouTube | Copy Stream Key again from Scheduled Stream |
| Twitch | Copy Primary Stream Key from Settings |
| Create new Live Video post (keys expire) |
Stream Works Then Stops After Hours
| Cause | Solution |
|---|---|
| Platform ended stream | Use Scheduled Streams (YouTube) or enable Continuous (Facebook) |
| Camera disconnected | Enable Backup Stream in webcam.io |
| Network timeout | Check camera/router stability |
| Plan limit reached | Check your webcam.io plan limits |
Bandwidth Limit Reached
webcam.io has a 10 Mbit/s input bandwidth limit.
If exceeded:
- Reduce camera resolution
- Reduce camera frame rate
- Reduce camera bitrate
Common Mistakes
Using Local IP Address
❌ Wrong: rtsp://192.168.1.100:554/stream
✅ Correct: rtsp://myrouter.dyndns.org:554/stream
webcam.io cannot access your local network. Use your external IP or DDNS hostname.
Forgetting Port in URL
❌ Wrong: rtsp://myrouter.dyndns.org/stream
✅ Correct: rtsp://myrouter.dyndns.org:554/stream
Always include the port number (usually 554 for RTSP).
Wrong Output URL Format
YouTube:
rtmp://a.rtmp.youtube.com/live2/xxxx-xxxx-xxxx-xxxx
Twitch:
rtmp://live-fra02.twitch.tv/app/live_123456_AbCdEfGh
Facebook:
rtmp://live-api.facebook.com:80/rtmp/123456?ds=1&a=xxxxx
Clicking “Finish” on Facebook
This permanently ends the live video. You must create a new one.
Using YouTube “Stream Tab” for 24/7
The Stream Tab doesn’t auto-reconnect. Use Scheduled Streams instead.
Diagnostic Tools
Test Camera URL with VLC
- Download VLC
- File → Open Network Stream
- Enter your camera URL (external, not local)
- If it plays, camera is accessible
Check Port Forwarding
- Go to portchecker.co
- Enter your external IP and port (554)
- Should show “Open”
Check Upload Speed
- Go to speedtest.net
- Run test
- Upload should be at least 1.5× your stream bitrate
Platform Stream Health
| Platform | Where to Check |
|---|---|
| YouTube | Live Control Room → Stream Health |
| Twitch | Creator Dashboard → Stream Health |
| Live Producer → Stream Health |
When to Contact Support
Contact webcam.io support if:
Include in your message:
- Your webcam ID (from Dashboard)
- Screenshot/Text of status/error
- Your camera model
- What you’ve already tried
FAQ
Why does my stream keep restarting?
Usually camera connectivity. Test your RTSP URL with VLC from outside your network. See Connection Problems.
Why is my stream offline on YouTube but online in webcam.io?
YouTube’s Stream Tab doesn’t auto-reconnect. Switch to Scheduled Streams. See YouTube Issues.
Can webcam.io access my camera behind a firewall?
Only if you set up port forwarding or use a VPN/tunnel. webcam.io needs to reach your camera from the internet.
Why is there a delay in my live stream?
All live streaming has latency (3-30 seconds depending on settings). This is normal and primarily determined by the platform’s latency setting.
Why is my video quality poor?
Usually camera bitrate is too low, or your upload bandwidth is insufficient. See Quality Issues.
Next Steps
- YouTube Streaming – Platform-specific guide
- Twitch Streaming – Platform-specific guide
- Facebook Streaming – Platform-specific guide
- Streaming FAQ – More common questions
- Contact Support – Get help