Skip to main content

Troubleshoot Premium Streaming issues

Follow this guide if you are experiencing any of these webcam streaming issues:

  • Webcam stream is stuck (buffering), or video frames dropped.
  • Choppy/jerky webcam stream.
  • No webcam stream at all.

1. Make sure you are eligible for the Premium Webcam Streaming#

  • You are eligible for the Premium Streaming (25 frames-per-second) if you are currently a Pro plan subscriber or in the free trial.
  • You are eligible for only the Basic Streaming if you are on the Free plan.

If you are not sure, follow this guide to find out if you are currently on a Free plan or a Pro plan.

If you are on the Free plan, follow this troubleshooting guide instead. Otherwise, continue onto the next step.

2. Check If the webcam streaming is stuck in the "Basic" mode#

Follow this guide to find out the current webcam streaming mode.

If the webcam streaming is in the "Premium (25fps)" mode,or the "Premium (compatibility)" mode, skip to the next troubleshooting step.

If it shows the "Basic" mode, you are only getting the Basic Streaming even if you should be getting the Premium Streaming. This is usually caused by one of the following reasons:

OctoPrint has not be restarted since you upgraded to Pro#

You need to restart OctoPrint after you have upgraded to the Pro plan to get the Premium Streaming to kick in.

Sometimes restarting OctoPrint is not enough. Try to reboot your Raspberry Pi in that case. If even that fails, try to unplug Raspberry Pi's power supply, wait for 30 seconds, and plug it back in.

The Premium Streaming is disabled#

By default, the Premium Streaming is enabled. Let's make sure it has not been disabled.

  1. Open OctoPrint settings page by clicking the wrench icon (๐Ÿ”ง).
  2. Scroll down the navigation bar on the left side.
  3. Click "Access Anywhere - The Spaghetti Detective" tab.
  4. Click the "Settings" button.
  5. Is "Disable the Premium Webcam Streaming" checked?

Uncheck the "Disable premium webcam streaming" if it's currently checked. Don't forget to click the "Save" button and restart OctoPrint afterward.


When "Disable the Premium Webcam Streaming" is checked, you only get the Basic Streaming even if you are on the Pro plan.


There are a few rare reasons why you may want to have the Premium Streaming disabled.

You are not using a Raspberry Pi#

The Premium Webcam Streaming requires Raspberry Pi to work. It is well tested on Raspberry Pi 4B, Raspberry Pi 3B/3B+, and Zero/Zero W.

If you are not running OctoPrint on a Raspberry Pi, The Spaghetti Detective plugin will fall back to the Basic Streaming.


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.

You didn't use an OctoPi image#

We strongly recommend you flash your Pi with the latest official OctoPi image.

The Premium Streaming may not work if you flashed your Pi with:

  • a Raspbian image and custom-installed OctoPrint;
  • an OctoPi version that is older than 0.15.0;
  • an OctoPi release candidate (RC) version;
  • or an OctoPi pre-release version.

Try "always stream in compatibility mode"#

In most cases, the Premium Streaming will automatically switch to the compatibility mode when the advanced mode fails. But there is a slight possibility it will get stuck in the "Basic" mode.

Try to set the compatibility mode set to "always" to see if it'll get it out of the "Basic" streaming mode. You need to restart the Raspberry Pi after the switch.

If none of the above worked#

Get help from a human.

3. Check if you get any stream at all#

After you open The Spaghetti Detective mobile app or web app, wait for up to 5 seconds for the webcam live stream to load.

If the webcam stream is coming in (left in the screenshot above) but the stream is choppy/jerky, follow this guide to fix it.

If you don't see any webcam stream (right), follow these steps below:

Check for server connection issues#

Server connection issues are the most common root causes for not having a webcam stream. Follow this troubleshooting guide to check if it's the case, and if it is, how to fix it.

Try "always stream in compatibility mode"#

Try to set the compatibility mode set to "always". You need to restart the Raspberry Pi.

None of the above solves the problem?#

Get help from a human.