Skip to main content

Timelapse Feature

Feature Description​

The timelapse feature automatically captures photos during the printing process and synthesizes them into a video after printing is complete, documenting the entire print process.

Important Notice

System Version Requirements: This feature requires FlyOS-Fast system version greater than or equal to v1.3.7 to function 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 Files​

Access the machine IP via browser, enter the Klipper management page, and locate the configuration files.

Step 6: Configure moonraker.conf​

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

Configuration Notes

The following is the basic configuration. Other parameters can be configured as needed.

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

Parameter Descriptions:

  • output_path: Path for saving the final video file
  • snapshoturl: Camera snapshot URL
  • frame_path: Path for saving temporary frame images

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 job, the system will automatically save frame images to the specified path
  2. Once 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
More Configuration Details

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

Notes​

Important Notice
  • Ensure sufficient storage space is available 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 upon restart; please back up important videos promptly
Loading...