Skip to main content

Timelapse Photography Function

Feature Description​

The timelapse photography function can automatically capture photos during the printing process and synthesize them into a video after printing is complete, recording the entire printing process.

Important Note

System Version Requirement: This function requires FlyOS-Fast system version greater than or equal to v1.3.7 to work properly.

Installation Steps​

Step 1: Clone the moonraker-timelapse Repository​

Connect to the device via SSH and execute the following command to clone moonraker-timelapse into the /data directory:

cd /data
git clone https://github.com/mainsail-crew/moonraker-timelapse.git

Link the timelapse.py component to Moonraker's components directory:

ln -s /data/moonraker-timelapse/component/timelapse.py /data/moonraker/moonraker/components/timelapse.py

Step 3: Copy the Configuration File​

Copy timelapse.cfg to the printer configuration directory:

cp /data/moonraker-timelapse/klipper_macro/timelapse.cfg /usr/share/printer_data/config/

Step 4: Create the timelapse Directory​

Create a timelapse folder in the printer data directory to save timelapse videos:

mkdir -p /usr/share/printer_data/timelapse

Step 5: Access the Configuration File​

Access the machine's IP via a browser, enter the Klipper management page, and locate the configuration file.

Step 6: Configure moonraker.conf​

Add the following configuration at the end of the moonraker.conf file:

Configuration Description

The following is the basic configuration; other parameters can be configured based on actual needs.

[timelapse]
output_path: /usr/share/printer_data/timelapse/
snapshoturl: http://localhost:8080/webcam/?action=snapshot
frame_path: /tmp/timelapse

Parameter Description:

  • output_path: Final video file save path
  • snapshoturl: Camera snapshot URL address
  • frame_path: Temporary frame image save path

Step 7: Add Configuration File Reference​

Add the following to the printer.cfg file:

[include timelapse.cfg]

Step 8: Restart the Service​

After configuration, restart the Moonraker service to apply the changes.

Usage Instructions​

  1. After starting a print task, the system will automatically save frame images to the specified path
  2. After printing is complete, the images will be automatically synthesized into a video file
  3. The video file is saved in the /usr/share/printer_data/timelapse/ directory
Further Configuration Details

For detailed configuration options and usage methods, please refer to the official documentation: moonraker-timelapse GitHub

Notes​

Important Notes
  • Ensure there is sufficient storage space for saving timelapse files
  • When printing large files, it is recommended to adjust the capture interval in the configuration
  • The /tmp/timelapse directory will be cleared after a restart; please back up important videos in time
Loading...