Skip to main content

Camera Connection and Usage

v1.4.0 supports GoCam

FLYOS-FAST v1.4.0 can also use GoCam. It supports real-time adjustment of UVC camera parameters through port 8080. For usage instructions, please see GoCam Camera Service. v1.3.10 and earlier versions, as well as platform images that do not include GoCam, continue to use the Crowsnest method described on this page.

Configuration order reminder

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

  1. Enable the service first: Make sure the crowsnest service has started and is running normally.
  2. Then configure the camera: After the service is running normally, proceed with the specific camera parameter settings.

If you have already done it in the wrong order: If you configured the camera first but the crowsnest service was not enabled, you usually need to delete that 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 plug the camera directly into the USB port of the host computer, not into other non-USB ports on the host computer.
  • Camera requirements: Please use a driver-free, plug-and-play USB camera. Such cameras can usually be used directly in Klipper environments on Linux, Armbian, and similar systems without installing additional drivers.
  • 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. For specific operations, please refer to its official documentation.

Important Notes​

Required Reading
  • Certain settings in the configuration file only take effect on the first system startup after flashing.
  • Due to the complexity of the configuration process, it is strongly recommended to connect the machine to the network first and then configure it through a browser.
  • This tutorial only covers the modifiable options.
Caution
  • It is recommended to use mainsail or fluidd web interfaces for configuration changes.
  • Do not enable webpage translation; otherwise, the system may fail to boot after saving.
  • It is best to avoid entering 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 the content below ######### PLEASE DO NOT EDIT THE FOLLOWING ######### in the configuration file.

How to Modify the Configuration File​

Modify the Configuration File After Flashing Is Complete​

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

The System Now Supports Online Configuration Modification​

  • If it is a regular configuration item, modify it on the system web configuration page and then restart the system for it to take effect.

    • Open the device IP address in a browser, for example: 192.168.1.2/
    • In fluidd, as shown on the left in the figure below, check -> Show Hidden Files.
    • In mainsail, as shown on the right in the figure below, uncheck -> Filter hidden files and folders.
    Loading...
    Loading...
    • At this point, you can see the .flyos-config folder. Entering this folder will show the sys-config.conf file.
    • The sys-config.conf file is a soft link to the configuration file config.txt in the removable disk FlyOS-Conf.
    Loading...
    • Open the sys-config.conf file, modify the configuration items that need to be changed, then Save -> Close, and restart for it to take effect.
    Loading...
    • Note: The format of configuration items in the sys-config.conf file is key=value; do not change it to key: value.
    • After modifying and saving, restart the system for it 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...