Skip to main content

Troubleshoot choppy/jerky Premium Streaming

If the Premium Stream is choppy only very occasionally for brief moments, you can reload the page and it should resume streaming just fine. There is nothing to worry about.

However, if the problem happens frequently enough, follow this guide to identify and fix the root cause.


Make sure you have gone through this comprehensive webcam streaming troubleshooting guide to rule out the basic steaming problems.


Just like any other live video streaming or video conferencing, The Spaghetti Detective Premium Streaming may be choppy or jerky occasionally when your phone or your computer doesn't have a robust Internet connection.

Possible reasons why the Premium Webcam Streaming is choppy/jerky:

  • Your phone is connected to a cellular network that has a weak reception, low bandwidth, or high latency.
  • Your Raspberry Pi doesn't have a reliable Internet connection, especially if the Pi is connected via Wi-Fi.
  • The webcam is not properly connected to the Raspberry Pi.
  • The webcam resolution is set too high.
  • The webcam streaming frame rate is set too high. This can happen only when the webcam is streamed in compatibility mode.

1. Check the webcam streaming mode

Follow this guide to find out your webcam's current streaming mode.

If the webcam streaming mode is "Basic Streaming":

Basic Streaming is fixed at 0.1 fps (1 frame every 10 seconds). That's why it appears to be very choppy.

You need to upgrade to the Pro plan to get the buttery-smooth, 25 fps Premium Streaming.


Learn more about the difference between Premium Streaming and Basic Streaming.

If you are already on the Pro plan, follow this troubleshooting guide to figure out why the webcam is still in the Basic Streaming mode.

If the webcam streaming mode is "Premium (25ps)" or "Premium (compatibility)":

Continue to the next troubleshooting step.

2. Are you using a Raspberry Pi?

Raspberry Pi is required for the Premium Streaming. If you are not running OctoPrint on a Raspberry Pi, you will only get the Basic Streaming, which will be choppy as it only streams at 0.1 fps.

Continue to the next step if you are using a Raspberry Pi.


If you have installed docker on the Raspberry Pi, and are running OctoPrint inside the docker containers, you won't get the Premium Streaming either.


The reason why Raspberry Pi is required for the Premium Streaming is because it has a special hardware accelerator required to encode H.264 video efficiently.

3. Look for warning messages

Quite often, The Spaghetti Detective mobile app or web app can identify and diagnose the streaming issues when they happen. In that case, the app will show warning messages.

Depending on the nature of a streaming issue, the app may show one of both of the follow warning messages:

"Video frames dropped"

This usually indicates a connection bandwidth bottleneck. The bottleneck can be anywhere, but often it's either your phone's cellular connection, or the Raspberry Pi's Wi-Fi connection.


This may indicate a similar connection issue as the one above. But it may also indicate a webcam configuration issue on the Raspberry Pi.

4. Get help from a human

If none of the steps above helped you identify the problem, you can get help from a human.