Klipper en Android

Convierte tu teléfono o tablet Android antiguo en el host de Klipper para tu impresora 3D. Guía completa de instalación con Linux Deploy (root) y UserLAnd (sin root), conexión OTG y configuración paso

Una de las opciones más interesantes para reciclar hardware es usar un teléfono o tablet Android como host de Klipper, sustituyendo a la Raspberry Pi. Los dispositivos Android modernos cuentan con procesadores ARM de alto rendimiento, varios GB de RAM y almacenamiento interno suficiente para correr Klipper, Moonraker y Mainsail/Fluidd sin problemas.

¿Por qué Android?

• Reutilizas un móvil o tablet que tienes en un cajón

• Suelen tener más potencia que una Raspberry Pi Zero o Pi 3

• Pantalla integrada opcional con KlipperScreen

• Conectividad WiFi y Bluetooth de serie

Tutorial en español — Instalación de Klipper en Android

Requisitos

Hardware

• Teléfono o tablet Android — mínimo 2 GB de RAM (recomendado 3+ GB), 8+ GB de almacenamiento libre

• Android 8.0 o superior (recomendado Android 10+)

• Cable USB OTG (o adaptador OTG) para conectar la MCU de la impresora

• Cable USB-C Y (datos + carga) o placa que alimente el teléfono — necesario para usar OTG y cargar a la vez

USB OTG + carga simultánea es el mayor escollo en esta instalación. No todos los dispositivos lo soportan de forma nativa. Las opciones son:

1. Usar una placa impresora que pueda alimentar el dispositivo por USB (ej. BTT Octopus Pro con 5V en el puerto USB)

2. Usar un hub USB OTG con entrada de alimentación independiente

3. Retirar la batería del teléfono y alimentar directamente (avanzado, bajo tu responsabilidad)

Software y métodos disponibles

Método	Root necesario	Dificultad	Rendimiento	Notas
Linux Deploy	Sí (Magisk)	Media	Alto	Método más estable y documentado
UserLAnd	No	Baja	Medio	Más sencillo, algo más lento
KlipperPhonesLinux	No (flashing nativo)	Muy alta	Muy alto	Solo modelos específicos Xiaomi

---

Método 1 — Linux Deploy (recomendado, requiere root)

Linux Deploy crea un contenedor Debian completo dentro de Android aprovechando el entorno chroot. Es el método más estable y con mejor rendimiento.

Run Klipper, Moonraker y Fluidd en Android con Linux Deploy

Paso 1 — Rootear el dispositivo

Rootear un dispositivo puede anular su garantía y, si se hace incorrectamente, puede dejarlo inutilizable ("brickear"). Asegúrate de encontrar el procedimiento específico para tu modelo antes de continuar.

El método más recomendado actualmente es Magisk:

1. Descarga la imagen de stock de tu dispositivo desde el sitio oficial del fabricante

2. Extrae el boot.img de la imagen

3. Parchea el boot.img con la app Magisk (disponible en github.com/topjohnwu/Magisk)

4. Flashea el boot.img parcheado con fastboot

5. Verifica el root instalando Root Checker desde la Play Store

Paso 2 — Instalar apps necesarias

Instala desde la Play Store o F-Droid:

• Linux Deploy — el contenedor Debian

• BusyBox — utilidades necesarias para Linux Deploy

• JuiceSSH o similar — cliente SSH para conectarte al contenedor

Paso 3 — Configurar SELinux en modo permisivo

Para que Linux Deploy pueda montar el contenedor correctamente, SELinux debe estar en modo permisivo:

1. Instala SELinuxModeChanger (búscalo en GitHub o F-Droid)

2. Cambia el modo de Enforcing a Permissive

3. Reinicia el dispositivo

En algunos dispositivos también es necesario añadir la siguiente ruta al PATH en la configuración de Linux Deploy: /data/user/0/ru.meefik.linuxdeploy/files:/system/xbin

Paso 4 — Crear el contenedor Debian en Linux Deploy

Abre Linux Deploy y configura el contenedor con los siguientes ajustes:

Bootstrap:
  Distro:          Debian (Bookworm / Bullseye)
  Architecture:    arm64 (o armhf en dispositivos más antiguos de 32 bits)
  Installation:    Directory
  Path:            /data/local/debian

Init:
  Enable:          yes
  Init system:     sysv

SSH:
  Enable:          yes
  Port:            22

GUI (solo si quieres KlipperScreen):
  Enable:          yes
  Graphics:        X11
  Desktop:         XTerm

Pulsa INSTALL y espera a que finalice la instalación (puede tardar varios minutos).

Paso 5 — Arrancar el contenedor y conectar por SSH

1. Pulsa START en Linux Deploy

2. Conéctate por SSH desde JuiceSSH o desde otro dispositivo en tu red:

ssh android@<IP_DEL_TELEFONO>
# Contraseña por defecto: android

1. Una vez dentro, actualiza el sistema:

sudo apt update && sudo apt upgrade -y

Paso 6 — Instalar Klipper con KIAUH

sudo apt install git -y
cd ~
git clone https://github.com/dw-0/kiauh.git
./kiauh/kiauh.sh

En el menú de KIAUH selecciona e instala en este orden:

1. 1) Install → 1) Klipper

2. 1) Install → 2) Moonraker

3. 1) Install → 3) Mainsail (o 4) Fluidd)

4. (Opcional) 1) Install → 5) KlipperScreen — tarda bastante, puede fallar en versiones antiguas de Debian

Si la instalación de KlipperScreen falla por la versión de Python, instala Python 3.11 desde source antes de continuar:

sudo apt install -y build-essential libssl-dev libffi-dev python3-dev
# Instalar Python 3.11 desde los repositorios de Debian Bookworm
sudo apt install python3.11 python3.11-venv

Paso 7 — Corregir los paths de socket (si hay problemas)

En algunos casos Klipper y Moonraker no se comunican bien por los paths de socket por defecto. Comprueba y ajusta si es necesario:

En /etc/default/klipper:

KLIPPY_SOCKET=/home/android/printer_data/comms/klippy.sock

En ~/printer_data/config/moonraker.conf:

klippy_uds_address: /home/android/printer_data/comms/klippy.sock

En /etc/default/moonraker:

MOONRAKER_SOCKET=/home/android/printer_data/comms/moonraker.sock

Reinicia los servicios tras los cambios:

sudo service klipper restart
sudo service moonraker restart

---

Método 2 — UserLAnd (sin root)

UserLAnd es una app que permite ejecutar un entorno Linux completo sin necesidad de root. El rendimiento es algo inferior al método con Linux Deploy pero es mucho más accesible.

Instalación

1. Descarga UserLAnd desde la Play Store

2. Crea una nueva sesión → Elige Ubuntu o Debian

3. Selecciona conexión SSH

4. Espera a que el sistema base se instale (primera vez tarda varios minutos)

5. Conéctate por SSH con las credenciales que elegiste

Instalar Klipper con KIAUH

El proceso es idéntico al Método 1 desde el Paso 6. UserLAnd ya proporciona un entorno Debian/Ubuntu completo.

UserLAnd no necesita root pero puede tener problemas accediendo directamente a /dev/ttyACM0 o /dev/ttyUSB0. Si la impresora no se detecta, consulta el apartado de Conexión de la impresora más abajo.

---

Método 3 — KlipperPhonesLinux (avanzado, modelos específicos)

Este proyecto convierte el teléfono en un host Linux nativo (sin Android, directamente Debian), ofreciendo el máximo rendimiento. Solo está disponible para modelos específicos de Xiaomi (Redmi 3, Note 3, etc.).

Este método borra completamente Android del dispositivo y requiere flashear un kernel Linux nativo. Es el más complejo y está limitado a unos pocos modelos concretos.

Más información en: github.com/umeiko/KlipperPhonesLinux

---

Conexión de la impresora por USB OTG

Detectar el puerto serial de la MCU

Con el cable OTG conectado y la impresora encendida, ejecuta dentro del contenedor:

ls /dev/ttyACM* /dev/ttyUSB* 2>/dev/null

La MCU debería aparecer como /dev/ttyACM0 o /dev/ttyUSB0. Si no aparece, el driver del chip USB puede no estar incluido en el kernel del teléfono.

Si la MCU no se detecta (driver CH34x)

Muchas placas usan el chip USB-serial CH34x, que algunos kernels Android no incluyen. Solución con la app Octo4a:

1. Instala Octo4a desde GitHub (no publicar en Play Store)

2. Ábrela y espera a que detecte la impresora (incluye driver CH34x propio)

3. No es necesario usar OctoPrint dentro de Octo4a — solo la necesitas para el driver

4. El serial pipe se expone en: /data/data/com.octo4a/files

5. Monta esa ruta en Linux Deploy:

MOUNTS → Enable: yes
  Source: /data/data/com.octo4a/files
  Target: /home/android/octo4a

1. En printer.cfg, usa:

[mcu]
serial: /home/android/octo4a/serialpipe

Dar permisos al puerto serial

sudo chmod 777 /dev/ttyACM0
# o
sudo chmod 777 /dev/ttyUSB0

Para que el permiso sea permanente añade esta línea a /etc/rc.local:

chmod 777 /dev/ttyACM0

---

Configuración del printer.cfg

Una vez localizado el serial, edita tu printer.cfg con el serial correcto. Puedes obtenerlo con:

ls /dev/serial/by-id/

Y añadirlo en la sección [mcu]:

[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32f103xe_xxxxxxxx-if00

Para obtener una configuración base de tu electrónica consulta el repositorio oficial de Klipper o los repositorios específicos de cada marca que tenemos en la guía de instalación.

---

Acceso a la interfaz web

Una vez Klipper y Moonraker estén corriendo, accede a Mainsail o Fluidd desde cualquier navegador en tu red local:

http://<IP_DEL_TELEFONO>

Para encontrar la IP de tu teléfono dentro del contenedor ejecuta:

hostname -I

---

Inicio automático al arrancar Linux Deploy

Para que el contenedor y los servicios arranquen solos cuando enciendas el teléfono:

1. En Linux Deploy, activa Autostart en los ajustes

2. Activa también Run on startup para que Linux Deploy inicie el contenedor al arrancar Android

---

Solución de problemas frecuentes

Problema	Causa probable	Solución
El contenedor no monta	SELinux en modo Enforcing	Cambiar a Permissive con SELinuxModeChanger
/dev/ttyACM0 no aparece	Driver CH34x no disponible	Usar Octo4a para exponer el serial pipe
Klipper y Moonraker no conectan	Path de socket incorrecto	Verificar y ajustar los paths en los ficheros default y moonraker.conf
OTG + carga no funciona	Hardware no compatible	Usar hub USB OTG con alimentación externa o placa que alimente el USB
KlipperScreen falla al instalar	Versión Python demasiado antigua	Instalar Python 3.11 desde source o usar Debian Bookworm
El contenedor es muy lento	Poca RAM o dispositivo de 32b	Usar dispositivo con ≥3 GB RAM y arquitectura arm64

---

Comparativa con otros hosts

Host	Precio orientativo	Root/Complejidad	Rendimiento	Notas
Android (Linux Deploy)	0 € (reutilizas)	Alta (requiere root)	Alto	Ideal para reciclar hardware
Raspberry Pi Zero 2W	~20 €	Baja	Medio	Bajo consumo, compacto
Raspberry Pi 4 2GB	~45 €	Baja	Alto	Estándar de referencia
Orange Pi Zero 2W	~20 €	Media	Medio-Alto	Buena alternativa económica
PC con Windows (WSL)	0 €	Baja-Media	Muy alto	PC siempre encendido

Tenemos guías específicas para otros hosts alternativos en la sección de instalación.

---

Recursos adicionales

• github.com/d4rk50ul1/klipper-on-android — scripts de automatización para Linux Deploy

• github.com/umeiko/KlipperPhonesLinux — Linux nativo en móviles Xiaomi específicos

• KlipperScreen en Android (WiFi) — usar el teléfono como pantalla táctil de KlipperScreen desde otro host

• Grupo Telegram Klipper ES — comunidad de ayuda en español