Cómo configurar Spoolman con Klipper y Moonraker (Mainsail/Fluidd)

Si usas Klipper, Spoolman es la forma estándar de dejar de adivinar cuánto filamento queda en una bobina — es una base de datos de bobinas gratuita y autoalojada, y Moonraker tiene soporte integrado para ella, así que una vez conectada, tanto Mainsail como Fluidd muestran un selector de bobina y actualizan el peso restante automáticamente mientras se ejecuta una impresión. Aquí está la configuración, de principio a fin.

Antes de empezar

• Klipper y Moonraker ya instalados y funcionando — Spoolman se conecta a Moonraker, no reemplaza ninguna parte de tu instalación actual.
• Un lugar donde ejecutar el propio servidor de Spoolman: un contenedor Docker en la misma Raspberry Pi/SBC que Moonraker, o en una máquina independiente siempre encendida en tu red (un NAS, un servidor doméstico, cualquier cosa que se mantenga activa).
• Python 3.9+ si vas a ejecutar Spoolman fuera de Docker, aunque Docker es el camino que sigue la mayoría porque Spoolman distribuye una imagen oficial.

1. Ejecuta el servidor de Spoolman

La vía oficial es Docker Compose — descarga la imagen spoolman, dale un volumen persistente para su base de datos, y expón un puerto (7912 por defecto). Una vez que el contenedor esté funcionando, deberías poder abrir http://<spoolman-host>:7912 en un navegador y ver su interfaz web, vacía por ahora.

2. Apunta Moonraker hacia él

Abre moonraker.conf en el host de tu impresora y añade una sección [spoolman]:

[spoolman]
server: http://<spoolman-host>:7912

Sustituye <spoolman-host> por la dirección IP o el nombre de host donde se está ejecutando el contenedor de Spoolman — localhost si está en la misma máquina que Moonraker, la IP de la red local en caso contrario.

3. Reinicia Moonraker

sudo systemctl restart moonraker

Revisa el registro de Moonraker para ver una línea de conexión con Spoolman sin errores. Si no puede alcanzar el servidor, comprueba de nuevo la dirección y que el puerto realmente sea accesible desde el host de la impresora (un curl http://<spoolman-host>:7912 rápido desde esa máquina es la forma más rápida de confirmarlo).

4. Confirma que aparece en Mainsail o Fluidd

Ambas interfaces detectan la integración con Spoolman automáticamente en cuanto Moonraker la reporta — no hace falta instalar ningún plugin aparte. Deberías ver aparecer un selector de bobina en el panel de estado de impresión. Si todavía no está ahí, normalmente basta con recargar la pestaña del navegador a fondo; Moonraker no necesita un segundo reinicio.

5. Añade tus bobinas

En la interfaz web de Spoolman, añade un tipo de filamento (marca, material, diámetro, densidad) y después una bobina de ese filamento con su peso inicial. Haz esto para cada bobina actualmente en uso — es el único paso manual de toda la configuración, todo lo demás se actualiza solo a partir de aquí.

6. Asigna una bobina antes de imprimir

Elige la bobina activa en el selector que ahora muestran Mainsail/Fluidd antes de iniciar un trabajo. A partir de aquí, Moonraker informa a Spoolman del uso estimado a medida que avanza la impresión, y el peso restante de esa bobina baja automáticamente — sin báscula, sin resta manual.

Lo que esto no cubre

Spoolman ahora sabe qué queda físicamente en cada bobina. No te dirá cuánto costó realmente hacer una impresión, porque ese nunca fue su trabajo — para eso necesitas el precio por kilo que pagaste, el tiempo de impresión y tu tarifa eléctrica, todo en un mismo sitio. Si eso es lo siguiente en tu lista, aquí tienes cómo encajan juntos Spoolman y el cálculo de coste de pedidos en lugar de duplicarse.