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 installSi configuraste tu OS manualmente y no tienes ffmpeg, instálalo con:
sudo apt install ffmpegEl 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:
Activa la extensión añadiendo la sección [timelapse] en moonraker.conf:
Y añade el include en printer.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.
Accede a través del icono de engranaje (⚙) → Timelapse.

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.
Una vez instalado el componente, aparece una entrada Timelapse en el menú de navegación principal de Fluidd.
La configuración está disponible en Settings → Timelapse y ofrece las mismas opciones que Mainsail: modo de captura, aparcado del cabezal, opciones de renderizado y selección de cámara.
Si alguna opción aparece como solo lectura, es porque está definida en moonraker.conf. Elimínala del archivo para gestionarla desde la UI.
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:
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:
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:
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.
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.

Fluidd incluye una sección dedicada Timelapse en el menú de navegación principal. Desde ella puedes:
Previsualizar los vídeos generados directamente en el navegador
Navegar por los fotogramas capturados durante la impresión con el scrubber de frames
Descargar o eliminar los vídeos sin necesidad de SSH
Activar el renderizado manual si el autorenderizado no está habilitado
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:
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:
Printer Settings → Machine G-code → Before layer change G-code
Printer Settings → Custom G-code → Before layer change G-code

Extensions → Post Processing → Modify G-Code → Add a script → Insert at layer change → Before

Advanced Settings → GCode → Layer Change Gcode

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.
Última actualización