# Klipper [**Klipper**](https://www.klipper3d.org/) es un firmware open-source creado por [**Kevin O'Connor**](https://www.patreon.com/koconnor) 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/instalacion.md). {% embed url="" %} Grupo de Telegram en español para dudas y soporte de Klipper {% endembed %} ## ¿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 {% hint style="success" %} 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](/klipper/instalacion.md). {% endhint %} ## 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. {% hint style="info" %} 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. {% endhint %} ## 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](/klipper/instalacion.md) 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](/klipper/instalacion.md#instalando-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](/klipper/instalacion.md) 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. | {% hint style="info" %} **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. {% endhint %} ## 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. | {% hint style="warning" %} 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. {% endhint %} ### 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](https://www.klipper3d.org/Overview.html). ## ¿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) {% hint style="success" %} **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. {% endhint %} ## 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**](/klipper/instalacion.md), 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 {% content-ref url="/pages/-MXbzxFcjgWJXG3b4v51" %} [Instalación](/klipper/instalacion.md) {% endcontent-ref %} {% content-ref url="/pages/-M\_\_AtRY62iB7N60gJTS" %} [Configuración](/klipper/empezamos.md) {% endcontent-ref %} Si tienes dudas durante el proceso, el grupo de Telegram en español es el sitio más rápido para resolverlas: {% embed url="" %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://klipper.3dwork.io/klipper/klipper-1.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.