How to Adjust Webcam Focus in OctoPrint
Practical steps for setting manual webcam focus in OctoPrint, including camera settings, lens adjustment and checks for sharp 3D printer monitoring.
Before you start
Focus is usually controlled outside OctoPrint. OctoPrint receives the video stream, while the webcam or camera utility controls physical focus, autofocus and exposure. Check whether your camera has a fixed-focus lens, a manual focus ring, or software autofocus before changing settings.
For a USB webcam connected directly to the device running OctoPrint, make sure the stream is already visible in the OctoPrint interface. The selected camera should be active and the preview should update. Good lighting helps you judge sharpness while focusing.
Step-by-step instructions
Use these steps when the webcam feed is working but the print area looks soft or blurry.
1) Position the camera at the distance you normally use for monitoring the print. If you change the mounting distance later, you may need to refocus.
2) Open the webcam preview in OctoPrint so you can see the result while you work.
3) Place a detailed object where the nozzle or print surface normally appears. A printed calibration object, small text label or textured surface is easier to judge than an empty build plate.
4) If the lens has a manual focus ring, rotate it slowly until edges in the preview look sharpest. Avoid changing the camera position while adjusting.
5) If the camera has autofocus, disable it first and set focus manually. This prevents the camera from refocusing when the print head moves through the frame. Autofocus settings may be available in the camera utility, not in OctoPrint itself.
6) If the lens is fixed-focus, do not force it. Instead, change the distance between the camera and the print bed until the image is acceptably sharp.
7) Tighten any locking screw or ring gently after focusing so vibration from the printer does not shift the lens.
Check the output
Look at the live preview after focusing. Text, edges or small features on the test object should be clearly defined where the print area sits. Movement of the print head may produce some motion blur, especially at a low frame rate, so judge sharpness while the printer is still or the head is at the edge of the view.
If the image looks blocky or noisy, the issue may be resolution or lighting rather than focus. Compare the feed at the configured resolution and check that the camera is not trying to work in very low light.
Common problems and next steps
If the preview stays blurry after lens adjustment, check whether the lens surface is clean. Fingerprints, dust or printing residue can reduce contrast and make the feed look unfocused.
If OctoPrint shows upside-down or mirrored video, that usually means the camera setting for rotation or mirroring needs changing in the stream configuration rather than the focus. Confirm the preview orientation before making focus adjustments.
If you cannot find any focus options in OctoPrint, use the camera vendor's utility or the operating system tools on the device running OctoPrint. Not every camera exposes focus controls, and affordable USB webcams may have a fixed plastic lens that cannot be adjusted.
After changing focus, leave the camera settings unchanged during an actual print and check the stream once before relying on it for remote monitoring. If the printed object needs to be inspected closely at a different height, consider changing the camera position or adding light instead of constantly refocusing.