Timelapses

Cómo crear timelapses de tus impresiones con Klipper, compatible con Mainsail y Fluidd

La extensión moonraker-timelapse permite crear vídeos timelapse de tus impresiones directamente desde Klipper. Funciona con cualquier interfaz — tanto Mainsail como Fluidd — y es compatible con todos los slicers habituales.

¿Qué necesitas?

Una cámara conectada a tu host Klipper con una URL de snapshot accesible. Tienes sugerencias y guías de configuración en la sección de Cámaras.

Instalación

MainsailOS y fluiddPi ya incluyen el plugin preinstalado. Si usas alguna de estas imágenes, puedes saltarte este paso e ir directamente a Activación.

Si instalaste Klipper manualmente (KIAUH u otro método), instala el plugin via SSH:

cd ~/
git clone https://github.com/mainsail-crew/moonraker-timelapse.git
cd ~/moonraker-timelapse
make install

Si configuraste tu OS manualmente y no tienes ffmpeg, instálalo con:

sudo apt install ffmpeg

El script asume que Klipper y Moonraker están en ~/klipper y ~/moonraker.

Activación

Tanto si el plugin ya venía incluido como si lo acabas de instalar, hay que activarlo en los archivos de configuración.

Añade la extensión al gestor de actualizaciones de Moonraker en moonraker.conf:

moonraker.conf

[update_manager timelapse]
type: git_repo
primary_branch: main
path: ~/moonraker-timelapse
origin: https://github.com/mainsail-crew/moonraker-timelapse.git
managed_services: klipper moonraker

Activa la extensión añadiendo la sección [timelapse] en moonraker.conf:

moonraker.conf

[timelapse]
##   La configuración básica es suficiente para la mayoría de casos.
##   Solo descomenta lo que necesites cambiar.
#output_path: ~/timelapse/
#frame_path: /tmp/timelapse/
#ffmpeg_binary_path: /usr/bin/ffmpeg

Y añade el include en printer.cfg:

printer.cfg

[include timelapse.cfg]

Configuración desde la interfaz

Una vez instalado, tanto Mainsail como Fluidd incluyen un panel dedicado para gestionar el timelapse sin necesidad de editar archivos de configuración.

Mainsail

Accede a través del icono de engranaje (⚙) → Timelapse.

Interface Settings → Timelapse en Mainsail

Opción	Descripción
Enabled	Activa/desactiva las macros y el autorenderizado
Autorender	Renderiza el vídeo automáticamente al terminar la impresión
Camera	Selecciona qué cámara usar para las capturas
Mode	layermacro (captura en cada capa) o hyperlapse (por intervalo de tiempo)
Stream Delay Compensation	Retraso antes de capturar para compensar el lag del stream (por defecto 0,05 s)
Park Toolhead	Aparca el cabezal antes de cada captura (ver sección siguiente)
Variable FPS	Ajusta los FPS para alcanzar una duración objetivo del vídeo
Preview Image	Guarda una miniatura con el mismo nombre que el vídeo
Save Frames	Guarda los fotogramas en un ZIP para renderizado externo

Si defines snapshoturl en [timelapse] dentro de moonraker.conf, el selector de cámara de la UI queda deshabilitado. Para usar la selección desde la interfaz, no incluyas snapshoturl en el archivo de configuración.

Fluidd

Opciones avanzadas

Para configuración avanzada más allá de la UI, referencia completa en la documentación oficial.

Opciones más usadas en moonraker.conf:

[timelapse]
#enabled: True
#mode: layermacro          # layermacro | hyperlapse
#hyperlapse_cycle: 30      # segundos entre capturas en modo hyperlapse
#parkhead: False
#parkpos: back_left        # back_left | back_right | front_left | front_right | center | custom
#park_custom_pos_x: 0.0
#park_custom_pos_y: 0.0
#park_custom_pos_dz: 0.0
#park_travel_speed: 100
#park_retract_distance: 1.0
#park_extrude_distance: 1.0
#autorender: True
#constant_rate_factor: 23  # calidad del vídeo (menor = mejor calidad)
#output_framerate: 30
#variable_fps: False
#targetlength: 10          # duración objetivo del vídeo en segundos
#variable_fps_min: 5
#variable_fps_max: 60
#flip_x: False
#flip_y: False
#duplicatelastframe: 0
#previewimage: True
#saveframes: False

Aparcado del cabezal

La opción Park Toolhead (parkhead) mueve el cabezal fuera del área de impresión antes de cada captura. Esto evita que el nozzle tape la pieza en la foto y elimina las marcas de movimiento entre capas que pueden arruinar el resultado final.

Posiciones disponibles

Posición (parkpos)	Descripción
back_left	Esquina trasera izquierda (por defecto)
back_right	Esquina trasera derecha
front_left	Esquina delantera izquierda
front_right	Esquina delantera derecha
center	Centro de la cama
custom	Coordenadas personalizadas (ver parámetros a continuación)

Para la posición personalizada, configura en moonraker.conf:

[timelapse]
parkhead: True
parkpos: custom
park_custom_pos_x: 10.0    # posición X en mm
park_custom_pos_y: 10.0    # posición Y en mm
park_custom_pos_dz: 2.0    # elevación adicional del eje Z en mm
park_travel_speed: 100     # velocidad de desplazamiento en mm/s

Retracción durante el aparcado

Al aparcar el cabezal se puede retraer filamento para evitar babeo (oozing) durante la captura, y extruirlo de vuelta antes de continuar imprimiendo:

[timelapse]
park_retract_distance: 1.0   # mm de retracción al aparcar
park_extrude_distance: 1.0   # mm de extrusión al volver (igual o mayor que retract)

Si ya tienes firmware retraction activo en Klipper, ajusta estos valores a 0.0 para evitar doble retracción.

Gestión de timelapses

Una vez completada la impresión, el vídeo timelapse queda guardado en el host. Puedes gestionarlos directamente desde la interfaz sin necesidad de SSH.

Mainsail

En el menú lateral encontrarás una sección Timelapse dedicada con todos los vídeos generados. Desde ahí puedes descargar, previsualizar y eliminar los timelapses.

Sección Timelapse en Mainsail — lista de vídeos y espacio disponible en disco

Fluidd

Espacio en disco: Los timelapses se almacenan en ~/timelapse/ y los fotogramas temporales en /tmp/timelapse/ del host Klipper (normalmente una Raspberry Pi con tarjeta SD de 16-32 GB).

Una impresión larga puede generar cientos de fotogramas y vídeos de varios cientos de MB. Si el disco se llena, Klipper puede dejar de funcionar correctamente.

Revisa y limpia periódicamente la carpeta de timelapses desde la interfaz o via SSH:

ls -lh ~/timelapse/
rm ~/timelapse/nombre_del_timelapse.mp4

Configuración del laminador

Hay que añadir la macro TIMELAPSE_TAKE_FRAME en el G-code de cambio de capa del laminador. La ubicación exacta varía según el programa:

OrcaSlicer

Printer Settings → Machine G-code → Before layer change G-code

TIMELAPSE_TAKE_FRAME

PrusaSlicer / SuperSlicer

Cura

IdeaMaker

Con esto, cada vez que el laminador genere un G-code, ejecutará la macro en cada cambio de capa. Al finalizar la impresión, Mainsail o Fluidd renderizarán automáticamente el vídeo timelapse.