Articles on: Troubleshooting

Webcam not detected in SimplyPrint for Klipper-based printer (Mainsail, Fluidd, Moonraker)

Webcam not detected in SimplyPrint for Klipper-based printer (Mainsail, Fluidd, Moonraker)


If your webcam works in Mainsail or Fluidd, but not in SimplyPrint, there's most likely a simple reason, with an easy fix!


In SimplyPrint we use the "snapshot URL", also sometimes called "timelapse URL"; it's a link (URL) that simply gives us one picture from the webcam. So if the webcam stream for your Klipper-powered printer does not show up inside SimplyPrint, the webcam setup for the snapshot URL is most likely missing.


Mainsail & Fluidd guide:

Step 1: Check your Webcam settings

In the Mainsail "Webcams" settings, you need to check if the webcam has a "URL Snapshot". You can learn how to find it here; Mainsail: https://docs.mainsail.xyz/overview/settings/webcams, Fluidd: https://docs.fluidd.xyz/features/cameras


Step 2: Check that the snapshot URL is reachable

When you've made sure that your webcam has a "Snapshot URL", we need to make sure we can reach it. It will most likely be something like

/webcam/?action=snapshot


So, take the current IP address/URL of your Mainsail instance, e.g. http://192.168.1.50/ and add the snapshot URL part after that. If your snapshot URL is a full URL, with "http://" or "https://", you simply take the full URL from that, otherwise you add the snapshot URL to the end of your Mainsail IP so it becomes; http://192.168.1.50/webcam/?action=snapshot. Does that work? If not, your webcam may not support snapshots or the snapshot URL may be wrong.


Step 3: Tell SimplyPrint which camera to use (Moonraker configuration file)

If after step 2 the webcam still doesn't work in SimplyPrint, you may need to tell us which camera to use.


To do this, find the Moonraker configuration file (called "moonraker.conf" or "moonraker.generated.conf") in your settings. If you've set up SimplyPrint, this is where you added the [simplyprint] component. If you don't know where to find this file, check our setup guide; https://simplyprint.io/setup-guide#klipper:3


Now, as per the official Moonraker documentation for the SimplyPrint component (https://moonraker.readthedocs.io/en/latest/configuration/#simplyprint), you can set the webcam_name below the [simplyprint] component like this;

[simplyprint]
webcam_name: name_of_webcam


You can find the name of your webcam in the "webcam" part of the very same Moonraker config file; https://moonraker.readthedocs.io/en/latest/configuration.html#webcam.

While checking out the webcam settings of the camera, make sure it has a valid "snapshot_url" value.


Success!

Now the webcam should show up inside SimplyPrint! If not, please reach out to support, and we'd be happy to help you!


Creality K1 / K1C / K1 Max


If you have a Creality K1, K1C, or K1 Max, the camera setup works a bit differently. These printers use a Helper Script that needs to enable camera settings for Moonraker specifically.


We have a dedicated guide for this: Creality K1 / K1C / K1 Max camera not working - how to fix


Creality K2


If you have a Creality K2 and set it up with SimplyPrint before 2026, you may need to run the updated installer script to get the camera working. Head to the setup guide and re-run the installation:


Creality K2 setup guide

Updated on: 09/04/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!