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:

Dashboard status indicators
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)
Connection points
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:

Restarting causes
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:

  1. Find your external IP: whatismyip.com
  2. Open VLC → File → Open Network
  3. Enter: rtsp://YOUR-EXTERNAL-IP:554/your/camera/path
  4. If it doesn’t play, the camera isn’t accessible from outside

“Input format not recognized”

Symptom: Stream fails immediately with format error.

Solutions:

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

  1. Go to YouTube Studio → Live → Manage tab
  2. Click Schedule Stream
  3. Configure and create
  4. Use the new Stream Key in webcam.io
Don’t Use “Stream Tab”

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:

  1. Go to YouTube Live → Manage tab
  2. Your stream may show as “Ended”
  3. Create a new Scheduled Stream
  4. Select Reuse settings from previous stream
  5. Update stream key in webcam.io if changed

YouTube Shows “No Data” Despite Streaming

No data troubleshooting
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:

  1. Enable Auto-Delete in webcam.io (see YouTube Guide)
  2. Manually delete archives in YouTube Studio
  3. 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

Twitch visibility
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:

  1. Twitch → Settings → Channel and Videos
  2. 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:

  1. Enable Continuous Live Video in Facebook stream settings → Advanced
  2. Enable Backup Stream in webcam.io
  3. Never click Finish in Facebook (use Save instead)

To restart:

  1. Create a new Live Video post
  2. Get the new Stream Key
  3. 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:

  1. Create new Live Video post in Facebook
  2. Get new Stream Key
  3. Update webcam.io immediately

Video Quality Issues

Pixelated or Blocky Video

Pixelation causes
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:

Bitrate recommendations
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

Choppy playback causes
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:

Latency by platform
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:

  1. Access your camera’s web interface
  2. Adjust exposure/brightness settings
  3. Enable auto-exposure if available
  4. Check for backlight compensation

Transcoding Issues

“Transcoding required” Error

Cause: Your camera codec isn’t directly supported by the streaming platform.

Transcoding requirements
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:

Transcoding presets
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:

  1. Verify camera is sending audio in the stream
  2. Check platform supports audio (all major ones do)
  3. Contact support — may need server-side adjustment

Platform Connection Issues

“Invalid stream key” Error

Invalid key solutions
Platform Solution
YouTube Copy Stream Key again from Scheduled Stream
Twitch Copy Primary Stream Key from Settings
Facebook Create new Live Video post (keys expire)

Stream Works Then Stops After Hours

Stream stopping causes
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:

  1. Reduce camera resolution
  2. Reduce camera frame rate
  3. 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

  1. Download VLC
  2. File → Open Network Stream
  3. Enter your camera URL (external, not local)
  4. If it plays, camera is accessible

Check Port Forwarding

  1. Go to portchecker.co
  2. Enter your external IP and port (554)
  3. Should show “Open”

Check Upload Speed

  1. Go to speedtest.net
  2. Run test
  3. Upload should be at least 1.5× your stream bitrate

Platform Stream Health

Stream health locations
Platform Where to Check
YouTube Live Control Room → Stream Health
Twitch Creator Dashboard → Stream Health
Facebook Live Producer → Stream Health

When to Contact Support

Contact webcam.io support if:

Include in your message:

  1. Your webcam ID (from Dashboard)
  2. Screenshot/Text of status/error
  3. Your camera model
  4. 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

Back to top