Skip to main content

Camera Connection and Usage

Important Note

Due to limited device memory (512MB), running the camera function may lead to insufficient memory, potentially causing device stuttering or other issues.

Configuration Order Reminder

Please strictly follow the steps below, otherwise the camera may not be recognized:

  1. Enable the Service First: Ensure the crowsnest service is started and running properly.
  2. Configure the Camera Second: After the service is running normally, proceed with the specific camera parameter settings.

If you have made an error: If you configured the camera without enabling the crowsnest service, you will typically need to delete the camera configuration in the Web interface and then add it again to ensure the configuration takes effect.

Note: This refers to deleting the camera configuration entry in the Web interface, not deleting the crowsnest.cfg configuration file.

Connection and Configuration Notes
  • Connection Method: Please connect the camera directly to the USB port of the host, not to other non-USB ports on the host.
  • Camera Requirements: Use a driverless, plug-and-play USB camera. Such cameras are typically usable directly in Klipper environments on Linux, Armbian, and other systems without the need for additional driver installation.
  • Software Environment: This tutorial is written based on the latest versions of Klipper, Crowsnest, and Fluidd. If you use Mainsail or another frontend, the configuration principles are similar. Please refer to their official documentation for specific steps.

Important Note​

Must-Read
  • Some settings in the configuration file will only take effect when the system starts for the first time after flashing.
  • Due to the complexity of the configuration process, it is strongly recommended to connect to the machine via the network and configure it through a browser.
  • This tutorial only covers modifiable options.
Attention
  • Try to use mainsail or fluidd web pages for configuration changes.
  • Please do not enable webpage translation, otherwise the system may fail to start after saving.
  • It is best not to input Chinese characters or special characters in the configuration file.
  • After modifying the configuration file, the system needs to be restarted for the changes to take effect.
Danger
  • Do not modify any content below ######### PLEASE DO NOT EDIT THE FOLLOWING ######### in the configuration file.

How to Modify the Configuration File​

Modifying the Configuration File After Flashing​

  • Configuration items that only take effect on first startup must be modified after flashing by opening the configuration file config.txt on the removable disk FlyOS-Conf using a professional text editor.

System Supports Online Configuration Modification​

  • For regular configuration items, you can modify them on the system's web configuration page and then restart the system for the changes to take effect.

    • Enter the device's IP address in the browser, e.g.: 192.168.1.2/
    • In fluidd, as shown on the left below: Uncheck -> Filter hidden files and folders.
    • In mainsail, as shown on the right below: Check -> Show hidden files.
    Loading...
    Loading...
    • At this point, you can see the .flyos-config folder; entering this folder will reveal the sys-config.conf file.
    • The sys-config.conf file is a symbolic link to the configuration file config.txt on the removable disk FlyOS-Conf.
    Loading...
    • Open the sys-config.conf file, modify the desired configuration items, then Save -> Close and restart the system.
    Loading...
    • Note: The format of configuration items in the sys-config.conf file is key=value; do not change it to key: value.
    • After saving the modifications, restart the system for the changes to take effect.

Enable Crowsnest Service​

  • Search for crowsnest=0 in the configuration and change it to crowsnest=1
  • Save the configuration after modification and restart the system
  • Please note that after modifying the configuration file, the system needs to be restarted for the changes to take effect.
    Loading...

Open Configuration​

Tip
  • There are many types of camera IDs depending on the system; we only need to confirm the ID that will not change.

  • Find the configuration file in Fluidd, then open crowsnest.conf

    Loading...

  • Locate device: and delete the ID configuration that follows.

    Loading...

Search for Camera ID​

Tip
  • Ensure the camera is connected to the host computer
  • Click DEVICES at the top, then click VIDEO, and finally click Refresh
    Loading...
  • Find path_by_id and copy the line that follows
    Loading...

Add ID​

  • Add the ID and save the configuration
    Loading...

Enable Camera​

  • Click Settings, select Camera, then click Add Camera
    Loading...
  • Enter a name of your choice and click Save
    Loading...

Check if Enabled​

  • The camera feed should appear on the dashboard
    Loading...
  • If it does not display, restart the system again
Loading...