Skip to main content

Troubleshoot the webcam 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.

Determine if you are eligible for the Premium Webcam Streaming

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

Troubleshoot the Premium Streaming issues

Follow the steps below if you are eligible for the Premium Streaming.

1. Check if the streaming is stuck in the "Basic" mode

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

The streaming mode should be "Premium (advanced)" or "Premium (compatibility)". If the streaming mode is stuck in "Basic", follow this troubleshooting guide.

2. 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), continue to the next step.

3. 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.

4. Try "always stream in compatibility mode"

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

5. None of the above solves the problem?

Get help from a human.

Troubleshoot the Basic Streaming issues

Follow the steps below if you are only eligible for the Basic Streaming.

1. Is your 3D printer currently printing?

The Basic Streaming is activated only when your 3D printer is printing.

If your 3D printer is not printing right now, please start a test print. After about 30 seconds, check if you are getting the webcam stream in The Spaghetti Detective app now.

If the webcam stream still doesn't come up, continue to the next step of this guide.

2. Open the troubleshooting page.

The Spaghetti Detective plugin has a powerful troubleshooting page to help you diagnose the webcam streaming problems.

You can access this troubleshooting page by:

  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 "Troubleshooting" button.

3. Examine connection status on the troubleshooting page

In the "Plugin Status" column, look for:

  • The "Connection to server" status, and
  • The "Connection to webcam" statuses

3.1 If the server connection has issues

When the plugin has problems connecting to The Spaghetti Detective server, the webcam stream won't come through either.

Follow this guide to fix the server connection problem first. Come back to this guide if the webcam streaming still doesn't work after the server connection problem is fixed.


You can still get a decent webcam stream even if there are occasional server connection errors, e.g., the error rate is lower than 5%.

3.2 If the webcam connection shows "Error"

This usually means the webcam streaming in OctoPrint is not working. Follow this troubleshoot guide to figure out why and fix it.

4. None of the above solves the problem?

Get help from a human.