Skip to main content

Timelapse Feature

Feature Description​

The timelapse feature automatically captures photos during the printing process and compiles them into a video after printing is complete, documenting the entire printing 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

Create a symbolic link for the timelapse.py component to the Moonraker 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 under the printer data directory to store timelapse videos:

mkdir -p /usr/share/printer_data/timelapse

Step 5: Access the Configuration Files​

Access the machine's IP via a 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 a 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: Final video file save path
  • snapshoturl: Camera snapshot URL; must match the currently enabled camera service
  • 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 Services​

After configuration, restart the Moonraker service for the changes to take effect.

Usage Instructions​

  1. After starting a print job, the system will automatically save frame images to the specified path
  2. After printing is complete, the images will be automatically compiled 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 instructions, please refer to the official documentation: moonraker-timelapse GitHub

Important Notes​

Important Notice
  • Ensure sufficient storage space is available to save 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...