If you have a Free account
Webcam streaming for Free account is up to 1 frame per 10 seconds. Also the streaming stops when the printer is not printing. If the streaming is significantly slower than that frame rate, please submit a bug report.
If you have a Pro account or are in Free trial period
There are several reasons why you may be getting laggy webcam streaming even if you have upgraded to the Pro plan.
1. You have NOT restarted OctoPrint.
This is the most common cause of not getting premium webcam streaming right after you upgrade to Pro. This is also the easiest to solve.
2. Your phone doesn't support the streaming protocol.
Under the hood TSD uses H.265 over WebRTC to stream the video. That's why it can stream at such a high frame rate without overloading the weak CPU in Raspberry Pi.
However, because this streaming protocol is quite new, it's not supported in all phones yet. Here is how you can determine if your phone supports TSD video streaming:
iPhone with iOS 11+. If you have an iPhone, you are in luck as the support for WebRTC is solid. The video streaming works on any iPhone or iPad that can be upgraded to iOS 11 or above.
Android phones... The support of WebRTC on Android devices is a lot more complicated. Here is the rule of thumb:
- Phones that run Android 9+: YES.
- Phones that run Android 8.x: Maybe. You can try it to see if it works.
- Phones that can't be upgraded to Android 8.0. No. :(
To check if this is the cause of the laggy streaming, try to load the page on a computer. If you are getting a smooth 25-frames-per-second video stream on your computer but not your phone, your phone unfortunately doesn't support the streaming protocol.
3. You are not using a Raspberry Pi.
Premium video streaming requires Raspberry Pi to work. It is well tested on Raspberry Pi 4B, Raspberry Pi 3B/3B+, and Zero/Zero W. We strongly recommend you to flash your Pi with the official OctoPi image. It may not work if you flashed your Pi with Raspbian image and custom-installed OctoPrint. This also includes Pi 4B users who used pre-release images.
4. Your webcam is not supported.
TSD webcam streaming is well tested and known to work on any Pi Camera (genuine or off-market), as well as USB webcams that are relatively new. For details see webcam compatibility table.
5. You are using Chrome
We all love Chrome. Well, we used to. But time and time again our users reported to us that, after they switched to Firefox, mysterious webcam streaming problems went away, or the video stream loaded faster. And this is true on both smart phones and laptops. So try Firefox to see if your webcam streaming problem will go away.
If you are stuck with Chrome, you may want to try one of the workarounds to make it less annoying.
6. When everything fails...
If none of the situations above applies to you and you are still not getting premium video streaming, please email us. If you have the Pro plan we confirm that premium webcam streaming doesn't work for you, you are not completely out of luck - we will give you 300 Detective Hours each month to compensate for the situation.
Let us know if premium webcam streaming works for you
Does 25 fps webcam streaming work for the camera you have? Let us know by filling out this survey.
Webcam streaming compatibility
Webcams known to work with TSD premium video streaming
|Pi Camera||Both genuine and off-market units|
|Pi Camera V2||Both genuine and off-market units|
|Pi NoIR Camera V2|
|Logitech C270 HD Webcam|
|Logitech C920 HD Webcam|
|Logitech C922 HD Webcam|
|Logitech C910 HD Webcam|
|Microsoft||Specific model No not available (not a LifeCam, which is not supported. See below.)|
|LOETAD HD 1080P(B07FVZPWMG)|
|HP HD webcam||Specific model No not available|
|Logitech QuickCam Pro 9000|
Webcams known to NOT work with TSD premium video streaming
|ASHU Webcam 1080P|
|Creative Labs VF0400|
|Microsoft Lifecam||This webcam can stream but it'll cause Pi to freeze. Disable premium webcam streaming if you are using this webcam.|
Slow video loading on Chrome
Chrome is not the most video streaming-friendly browser. One annoying problem it has for some users is that the video takes 10 seconds or even longer to load. If you have this problem, the easiest solution is to switch to Firefox or Safari. Even IE Edge works better. However, if you still want to stick with Chrome, there are 2 workarounds for this problem. You only need to do one of them.
Open a Chrome tab and copy-paste
chrome://flags/#enable-webrtc-hide-local-ips-with-mdnsin the address bar.
The Chrome setting that says "Anonymize local IPs exposed by WebRTC." will be highlighted.
Change the option to "Disabled".
Restart Chrome to let the change take effect.
SSH to the Raspberry Pi. Here is how.
/etc/nsswitch.confwith your favorite editor.
#in front of the line
hosts: files mdns4_minimal [NOTFOUND=return] dns. Add a new line
hosts: files dns. So
... #hosts: files mdns4_minimal [NOTFOUND=return] dns hosts: files dns ...
- Restart OctoPrint.