Klipper

Klipper es un firmware open-source creado por Kevin O'Connor en 2016. A diferencia de Marlin —que corre completamente en la electrónica de la impresora—, Klipper divide el trabajo entre dos piezas de hardware: un ordenador host (habitualmente una Raspberry Pi u otro SBC con Linux) que se encarga de todo el procesado, y la electrónica de la impresora que actúa como gestor de motores y sensores.

El resultado: puedes sacarle todo el partido a electrónicas lentas y baratas, aplicar cambios de configuración sin recompilar nada y tener funciones avanzadas que en Marlin son imposibles o muy limitadas. Si ya tienes claro que quieres instalarlo, ve directamente a la guía de instalación.

Klipper - ES 🇪🇸Telegram

Grupo de Telegram en español para dudas y soporte de Klipper

¿Qué necesito saber antes de instalar Klipper?

Klipper no es difícil, pero sí requiere un mínimo de base técnica. Si vienes de Marlin con poca experiencia, prepárate para aprender algunas cosas nuevas. Si ya tienes soltura con ordenadores y sistemas Linux, la curva de aprendizaje es más suave de lo que parece.

Conocimientos mínimos necesarios:

• SSH y terminal Linux: tendrás que conectarte por SSH a tu Raspberry Pi para instalar componentes, revisar logs y lanzar comandos. No necesitas ser administrador de sistemas, pero sí saber abrir un terminal, moverte por directorios (cd, ls) y editar ficheros (nano o similar).

• Edición de ficheros de texto: la configuración de Klipper son ficheros .cfg. Tienes que sentirte cómodo abriéndolos, editándolos y guardándolos. No hay compilador: editas, guardas, reinicias Klipper y los cambios están activos.

• Lectura de mensajes de error: Klipper es muy explícito en sus errores. Cuando algo falla, el mensaje en Mainsail/Fluidd indica exactamente qué fichero y qué línea tiene el problema. Saber leer esos mensajes sin entrar en pánico es la habilidad más valiosa.

• Paciencia en la puesta en marcha: la primera instalación lleva tiempo. Es normal. Una vez tienes la máquina funcionando, los cambios futuros son rápidos.

No necesitas:

• Saber programar ni Python

• Compilar código (salvo el firmware inicial de la MCU, que se hace con un par de comandos guiados)

• Experiencia previa con Linux avanzado

Si ya has usado OctoPrint con Marlin, tienes la mitad del camino hecho. La lógica de tener un host que controla la impresora te resultará familiar. El proceso de instalación está detallado paso a paso en la guía de instalación.

Cómo funciona Klipper — Arquitectura

En un ecosistema Klipper conviven varios componentes que trabajan juntos:

• Host Klipper (Klippy): el programa principal que corre en el SBC. Lee los ficheros .cfg, procesa los G-codes durante la impresión y toma todas las decisiones de movimiento. Al correr en un procesador potente, puede hacer cálculos en tiempo real que una MCU de impresora no podría.

• MCU Klipper: la electrónica de la impresora. Con Klipper, la MCU ya no "piensa" — solo recibe órdenes del host (mover este motor X pasos, leer este sensor, activar este calentador) y las ejecuta. Esto es lo que permite usar electrónicas antiguas y lentas con excelentes resultados.

• Moonraker: la API que hace de puente entre Klipper y el resto del mundo. Las interfaces web, las aplicaciones móviles y las integraciones externas hablan con Moonraker, que traduce esas peticiones a comandos para Klipper.

• Interfaz web (Mainsail, Fluidd): el panel de control visual. Desde aquí monitorizas temperaturas, lanzas impresiones, ejecutas macros y ajustas la configuración. Son accesibles desde cualquier navegador de tu red local.

• KlipperScreen (opcional): una interfaz táctil para pantallas conectadas directamente al SBC. Ideal si quieres controlar la impresora sin abrir el ordenador.

Una de las grandes ventajas de esta arquitectura es que puedes actualizar Klipper en segundos desde la propia interfaz web, sin tocar la electrónica. Los cambios de configuración se aplican con un simple reinicio del servicio, no con una recompilación y flasheo.

El ecosistema actual

Klipper ha crecido mucho desde sus inicios. Hoy tienes varias opciones para instalarlo y gestionarlo.

Distribuciones listas para usar

La forma más rápida de empezar: imagen lista para grabar en tu tarjeta SD con todo preinstalado. Consulta la guía de instalación para el proceso detallado de cada una.

Distribución	Descripción
MainsailOS	La más usada. Raspberry Pi con Klipper + Moonraker + Mainsail preinstalados. Lista en minutos. Recomendada para empezar.
FluiddPI	Igual que MainsailOS pero con Fluidd como interfaz.
RatOS	Orientada a impresoras RatRig pero compatible con muchas otras. Incluye configuraciones base muy completas y un sistema de overrides muy bien pensado.

Instalador manual

Herramienta	Descripción
KIAUH	Script interactivo en bash que instala y gestiona todos los componentes de Klipper. La opción más flexible si no usas Raspberry Pi o quieres control total sobre la instalación. Ver guía de instalación con KIAUH.

Variantes de Klipper

Variante	Descripción
Klipper oficial	La versión estándar mantenida por Kevin O'Connor y la comunidad. La referencia, la más estable.
Kalico (ex Danger Klipper)	Fork con funciones experimentales que aún no están en el oficial: mejoras en Input Shaper, gestión de temperatura avanzada, minimum_cruise_ratio (incorporado ya en el oficial), y otras optimizaciones. Adecuado para usuarios que quieren lo último aunque no esté 100% estabilizado.

Interfaces disponibles

Interfaz	Tipo	Descripción
Mainsail	Web	La más completa y popular. Gestión avanzada de macros, historial, actualizaciones.
Fluidd	Web	Más ligera, muy limpia visualmente. Buena opción en hardware con poca RAM.
KlipperScreen	Pantalla táctil	Para pantallas conectadas directamente al SBC.
OctoEverywhere	Acceso remoto	Acceso seguro desde fuera de tu red sin abrir puertos.
Mobileraker	App móvil	Control desde Android/iOS.

Klipper vs Marlin — Comparativa actualizada (2025)

	Klipper	Marlin
Arquitectura	Host (SBC Linux) + MCU como esclavo. Todo el procesado en el host.	Firmware compilado íntegramente en la MCU de la electrónica.
Configuración	Ficheros .cfg de texto plano. Cambios sin recompilar: editas, reinicias servicio, listo.	Requiere recompilar y reflashear la electrónica para cambiar funciones o parámetros de firmware.
Velocidad de impresión	Muy alta. El procesado en el host elimina los cuellos de botella de la MCU. Con Input Shaper calibrado, 300-500 mm/s es realista en máquinas preparadas.	Buena en electrónicas modernas de 32 bits. Limitada por la capacidad de cálculo de la MCU.
Input Shaping	Muy maduro. Calibración con acelerómetro (ADXL345, LIS2DW12). Klipper 0.13: sweeping resonance testing (barre frecuencias en movimiento continuo, más rápido y preciso).	Disponible desde Marlin 2.1.2. Funcional pero menos flexible. También requiere acelerómetro para calibración precisa.
Pressure / Linear Advance	Pressure Advance muy preciso. Proceso de calibración ágil mediante macros.	Linear Advance. Compatible con muchas electrónicas y bien documentado.
Mallado de cama	Mallado adaptativo nativo (Klipper 0.12+). Sondea solo el área que ocupa la pieza. Compatible con BLTouch, sensores inductivos, Eddy, etc.	Bilineal con parámetros de área (L/R/F/B) o UBL para mallas guardadas. Funcional pero menos integrado.
Macros	Sistema de macros muy potente (Jinja2). Puedes crear flujos complejos: inicio automático, calibración, cambio de filamento, notificaciones, etc.	G-code scripts básicos. Menos flexibles.
Soporte multiMCU	Soporte nativo. Puedes conectar varias placas a un mismo Klipper: MCU principal + toolhead CAN + host como MCU.	No soportado.
CANbus	Soporte nativo y maduro. Toolheads como EBB36, EBB42, SB2209, SB2240.	No soportado.
Pantalla LCD	Soporte limitado para LCDs en la MCU. KlipperScreen resuelve esto para pantallas en el SBC.	Soporte amplio y maduro para pantallas LCD estándar RepRap.
Instalación	Requiere configurar un SBC adicional. Las distribuciones (MainsailOS, FluiddPI) y la guía de instalación simplifican mucho el proceso.	Compilar y flashear. Sencillo con VSCode + PlatformIO. Sin hardware adicional.
Compatibilidad electrónicas	Muy amplia y creciendo. Prácticamente todas las placas modernas están soportadas.	La más amplia del mercado, incluyendo electrónicas antiguas de 8 bits.
Comunidad y documentación	Documentación oficial excelente. Comunidad muy activa en Discord, Telegram y grupos específicos de máquinas.	Documentación extensísima. La base de usuarios más grande del mundo.

Estado en 2025: Marlin ha cerrado distancias. La versión 2.1.2+ incluye Input Shaping con acelerómetro y el G29 Bilineal acepta parámetros de área para mallado adaptativo básico. Sigue siendo la mejor opción para impresoras de entrada/media gama con electrónicas sencillas, sin querer complicarse.

Klipper sigue siendo la referencia para máquinas de alto rendimiento, setups personalizados y cualquiera que quiera exprimir al máximo su impresora. La brecha de rendimiento se nota especialmente a partir de 150 mm/s.

Novedades recientes en Klipper

Klipper 0.13.0 — Abril 2025

La versión más reciente con mejoras importantes:

• Sweeping resonance testing: el nuevo método de calibración de Input Shaper barre las frecuencias mientras la máquina se mueve de forma continua, en lugar de vibrar a frecuencias fijas. Resultado: calibración más rápida y lecturas más precisas, especialmente en máquinas con múltiples picos de resonancia o cinemáticas complejas.

• minimum_cruise_ratio reemplaza a max_accel_to_decel: control más intuitivo de la velocidad de crucero en movimientos cortos. El valor recomendado es 0.5 (50% de la velocidad máxima para tramos de crucero muy cortos). Si migras de una versión anterior, elimina max_accel_to_decel de tu config y añade minimum_cruise_ratio: 0.5.

• Mallado adaptativo nativo: BED_MESH_CALIBRATE ADAPTIVE=1 ya no requiere KAMP. Klipper calcula automáticamente el área de la pieza y sondea solo esa zona, directamente desde el slicer.

• Soporte RP2350: el nuevo chip de Raspberry Pi (Pi Pico 2) ya está soportado.

• RP2040 a 200 MHz: las placas basadas en RP2040 (como BTT SKR Pico) pueden correr a mayor frecuencia, mejorando la resolución de pasos.

Klipper 0.12.0 — Noviembre 2023

• Modos IDEX COPY y MIRROR: impresión dual con dos cabezales en paralelo (copiar la pieza) o en espejo, para setups IDEX.

• Soporte TMC2240: drivers de alto rendimiento para setups exigentes con motores de mayor par.

• Axis Twist Compensation: corrección de torsión del eje X o Y para impresoras con gantries con ligera torsión mecánica.

Hardware necesario

El host (SBC)

Hardware	Valoración
Raspberry Pi 3B+	Mínimo recomendado. Funciona bien para la mayoría de impresoras.
Raspberry Pi 4 (2 GB+)	La opción más cómoda. Sobrada para cualquier setup. Recomendada si quieres correr cámara, timelapse y servicios adicionales.
Raspberry Pi 5	Más que suficiente. Especialmente útil para setups exigentes o múltiples instancias Klipper.
BTT Pi / Mellow FLY-Pi	Alternativas más económicas al Raspberry Pi con soporte oficial de Klipper. Buena opción si hay falta de stock.
Orange Pi / Rock Pi / similares	Compatible via KIAUH. Más económicos, soporte de la comunidad (no oficial).
PC o portátil viejo	Perfectamente válido si tiene Linux. Consume más energía pero funciona.

La versión de Raspberry Pi 4 con 1 GB de RAM puede quedarse justa si corres Klipper + cámara + timelapse de forma simultánea. La versión de 2 GB o superior es más cómoda.

La electrónica (MCU)

Prácticamente cualquier placa de impresora 3D moderna funciona con Klipper. Algunas de las más habituales:

• BTT: Octopus, Octopus Pro, Manta M8P/M5P, SKR series, Kraken

• Fysetc: Spider, S6

• MKS: Robin Nano, Skipr

• Creality: electrónicas de Ender 3 S1, Neo, algunas directamente, otras con adaptaciones

• Placas de 8 bits (RAMPS, Melzi...): funcionan, pero la velocidad de comunicación limita la frecuencia de pasos máxima. Úsalas solo si no tienes otra opción.

Para la lista completa de electrónicas soportadas, consulta la documentación oficial de Klipper.

¿Es Klipper para mí?

Klipper encaja bien si:

• Quieres imprimir rápido (150+ mm/s con calidad) sin sacrificar acabado

• Tienes o quieres montar una impresora tipo Voron, RatRig, Vzbot u otra CoreXY de alto rendimiento

• Quieres calibración automática avanzada (Input Shaper con acelerómetro, mallado adaptativo, Pressure Advance automatizado con macros)

• Disfrutas trastear, personalizar y entender cómo funciona tu máquina por dentro

• Tu electrónica es antigua o limitada y quieres exprimir al máximo la impresora sin cambiar la placa

• Quieres un sistema de macros potente para automatizar procesos: inicio, purga, cambio de filamento, notificaciones, etc.

• Tienes una impresora multimaterial, IDEX o configuración especial que Marlin no soporta bien

Marlin puede ser mejor opción si:

• Tienes una impresora cerrada o semi-cerrada donde no quieres meterte en profundidad

• Tu impresora es básica (Ender 3, Artillery, etc.) y ya funciona bien sin modificaciones

• No te apetece aprender Linux ni SSH

• Quieres algo que funcione sin necesidad de ajustar nada, que "simplemente funcione"

• No quieres instalar hardware adicional (el SBC)

La experiencia habitual: muchos usuarios de Marlin que dan el salto a Klipper reconocen que la puesta en marcha inicial les costó más de lo esperado, pero que a las pocas semanas ya no querrían volver. La clave está en la paciencia inicial y en tener claro que la curva de aprendizaje al principio es empinada pero corta.

Por dónde empezar

Si has decidido instalar Klipper, el camino más directo es:

1. Instalar MainsailOS en tu Raspberry Pi → sigue la guía de instalación, en 15 minutos tienes el host listo

2. Compilar y flashear el firmware en tu electrónica → específico para tu placa, detallado en la guía

3. Configurar el printer.cfg con los parámetros de tu impresora

4. Calibrar paso a paso: PID, extrusor, nivelación, Input Shaper, Pressure Advance

InstalaciónConfiguración

Si tienes dudas durante el proceso, el grupo de Telegram en español es el sitio más rápido para resolverlas:

Klipper - ES 🇪🇸Telegram