Herramientas autoalojadas para Spoolman

Moonraker y el plugin de Spoolman para OctoPrint se conectan a Spoolman directamente, y unos cuantos puentes extienden ese alcance a los AMS de Bambu y a las bobinas pesadas. PrintStash es el caso raro: consume Spoolman desde una capa superior, uniendo cada bobina a una impresión terminada y a sus gramos medidos. Esto es lo que hace de verdad cada conexión.

Spoolman espera a que lo conecten

Empieza por lo que es Spoolman, porque eso decide todo lo demás. Es una base de datos de fabricantes, filamentos y bobinas detrás de una pequeña API REST, con un cliente web encima. La propia wiki del proyecto lo dice sin rodeos: “It’s designed to work the other way around, these softwares connect to your installed Spoolman service.” Nada dentro de Spoolman sale a buscar una impresora. Si el consumo no aparece nunca en tu inventario, es que un cliente no informó, y el arreglo está en el cliente.

Las conexiones directas

En máquinas Klipper, Moonraker tiene una sección spoolman nativa en moonraker.conf. Apúntala a tu instancia de Spoolman, elige una bobina activa desde Mainsail o Fluidd, y Moonraker informa del consumo a Spoolman mientras se imprime. Esta es la vía a la que se refiere casi todo el mundo en Klipper cuando dice que lleva el control del filamento. Si todavía estás montando la parte de la impresora, conectar una impresora Klipper a través de Moonraker cubre esa base.

OctoPrint recibe el mismo trato mediante un plugin de la comunidad, octoprint-spoolman, que la propia wiki de Spoolman enlaza como la vía para OctoPrint. Las dos vías hacen el mismo trabajo: mueven cifras de consumo desde el controlador de la máquina a la base de datos de bobinas. Lo que ninguna lleva es el contexto. Spoolman acaba sabiendo cuánto se ha gastado de cada bobina, y su modelo de datos se queda en bobinas y filamentos, así que nada une los gramos a un modelo, a una revisión de G-code o a una máquina concreta.

Puentes para todo lo demás

Las impresoras de Bambu no tienen Moonraker, así que su historia con Spoolman pasa por intermediarios. Bambuddy, un panel autoalojado para máquinas Bambu, sincroniza las ranuras del AMS con Spoolman por RFID: las bobinas oficiales de Bambu reciben la actualización de peso restante y de ubicación automáticamente, y las etiquetas desconocidas se pueden crear solas o confirmar a mano. Su documentación es explícita en que las bobinas de terceros y las rellenadas se quedan fuera, porque la correspondencia funciona con identificadores de etiqueta de hardware y no con nombres de preajuste.

SpoolmanSync aborda Bambu desde otro lado. Vigila las impresoras a través de Home Assistant, te da una interfaz web para asignar bobinas y empuja el consumo a Spoolman desde ahí. FilaMan es el que llega más lejos en hardware: una báscula ESP32 que se pone debajo de la bobina, emparejada con un servidor que habla la API de Spoolman a propósito, así que los clientes de Klipper y OctoPrint que ya tienes funcionan contra él sin cambios mientras la báscula mantiene los pesos al día.

SimplyPrint entra en esta lista porque domina los resultados de búsqueda alrededor de Spoolman, y porque responde a la pregunta de forma distinta a los demás. Es software alojado cuyo gestor de filamento lee el G-code de las impresiones en las impresoras conectadas y descuenta el consumo por su cuenta. Según su propio posicionamiento, no se conecta a Spoolman, lo sustituye, que es una oferta razonable si la base de datos es justo la parte que no querías mantener.

La capa de la biblioteca

Hay otro tipo de herramienta que se conecta con Spoolman, y no se parece en nada a las demás. Una biblioteca de impresión no vive en la impresora y no sustituye al inventario. Se sitúa donde ya se acumulan los archivos, las revisiones y el historial de impresión, y usa esa posición para responder a una pregunta que la capa de la impresora no puede: ¿qué bobina entró en qué pieza terminada?

PrintStash es la biblioteca que hace esto hoy. Aviso: PrintStash es la herramienta detrás de este blog, así que pondera esta sección en consecuencia. Su integración con Spoolman es opcional y está apagada por defecto, y solo un superusuario puede activarla, lo que parece una precaución razonable en cuanto te das cuenta de que la integración guarda una clave de escritura para tu inventario. La configuración es una sola URL base que el servidor, no tu navegador, tiene que poder alcanzar; el direccionamiento hace tropezar a la gente cuando los dos contenedores comparten una red de Docker. La sincronización trae cada filamento de Spoolman como un preajuste de solo lectura con material, marca, densidad, diámetro y precio por kilo, así que Spoolman sigue siendo el único sitio donde se editan los datos de las bobinas. Cuando envías un trabajo, eliges la bobina, y esa elección pasa a formar parte del registro de la impresión. El recorrido completo está en seguimiento del uso de filamento con Spoolman.

La dirección interesante es la escritura de vuelta. En una impresión por Moonraker, PrintStash conoce los gramos que informó el firmware, no una estimación del slicer, y al terminar descuenta esa cantidad medida de la bobina elegida. Antes de escribir, comprueba si Spoolman ya tiene una bobina activa, lo que significa que el hook nativo de Moonraker está haciendo el mismo descuento, y PrintStash se retira; si desactivaste ese hook a propósito, un ajuste aparte de superusuario le dice a PrintStash que escriba de todas formas. Un Spoolman inalcanzable no bloquea nunca una impresión ni hace fallar una subida. Las lecturas vuelven vacías, la escritura se salta y el endpoint de salud anota la desconexión.

Ese emparejamiento de bobina elegida y gramos medidos, unido a un trabajo completado, es lo que no ofrece ninguna de las conexiones directas, porque ninguna sabe qué es un trabajo terminado. El límite es el alcance: la escritura de vuelta existe solo en Moonraker. Una impresora de Bambu con la integración LAN en beta de PrintStash no informa de ningún consumo, y en todos los demás proveedores los gramos siguen siendo la estimación del slicer, etiquetada como tal. Donde esas cifras se convierten en dinero, el coste real de filamento por impresión retoma la aritmética, y la guía de Spoolman tiene los pasos de configuración que este artículo deja a la documentación.

Preguntas que surgen

¿OrcaSlicer se conecta con Spoolman?

No. Ninguno de los slicers principales trae hoy una conexión con Spoolman. Los usuarios de OrcaSlicer mantienen peticiones de funcionalidad abiertas desde diciembre de 2023, y hasta que llegue una, la contribución del slicer al seguimiento es el peso estimado incrustado en el G-code. Las demás herramientas o usan esa estimación tal cual o la sustituyen después por una cifra medida.

¿Puede más de una herramienta actualizar la misma bobina de Spoolman?

Sí, y la wiki lo fomenta: una instancia de Spoolman puede servir a muchos clientes de Moonraker y de OctoPrint, incluso a varios que tiran de la misma bobina. El modo de fallo no es la concurrencia, es el doble conteo: la misma impresión restada dos veces por dos escritores. Esa es la razón por la que PrintStash comprueba la bobina activa de Spoolman antes de su propia escritura y se salta el paso cuando el hook de Moonraker ya está contando, con una excepción para quien haya desactivado ese hook a propósito.

¿Alguna herramienta de Bambu sincroniza con Spoolman?

Bambuddy sí, para las bobinas oficiales de Bambu reconocidas por RFID, actualizando peso y ubicación desde el AMS y creando opcionalmente las etiquetas desconocidas como bobinas nuevas. SpoolmanSync cubre las impresoras Bambu a través de Home Assistant. El soporte de Bambu por LAN en PrintStash está en beta y no informa de consumo de filamento, así que esas impresoras hoy no tienen nada que escribir de vuelta; lo que sabe del material del AMS son metadatos para mostrar, no inventario.

¿Qué conexiones informan de gramos medidos?

Las que tocan Moonraker. El hook nativo de Moonraker y la escritura de vuelta de PrintStash se apoyan en los gramos que informa el firmware, y las lecturas de Moonraker son las únicas comprobadas contra impresiones reales hasta ahora. Todo lo demás mueve cifras que nacieron como estimación de un slicer o como lectura de una báscula. Una báscula mide algo de verdad, solo que la bobina y no el trabajo, que es un hecho distinto.

¿Debería seguir siendo Spoolman mi inventario de referencia?

Si te lo autoalojas y quieres los datos en local, sí. Todas las herramientas descritas aquí tratan a Spoolman como la fuente de verdad para bobinas y precios, mientras los clientes leen de él e informan hacia él. Si prefieres no mantener la base de datos en absoluto, el gestor alojado de SimplyPrint es la alternativa coherente, y la forma honesta de plantearlo es sustitución y no conexión.

Fuentes

• Spoolman wiki, Automatic Filament Usage Tracking para la nota de diseño de que el software de impresora se conecta a Spoolman, y para las vías de Moonraker y OctoPrint. Comprobado el 22 de agosto de 2026.
• Moonraker configuration, la sección spoolman que enlaza la wiki para Klipper. Estado comprobado el 22 de agosto de 2026.
• octoprint-spoolman, el plugin que la wiki enlaza para OctoPrint. Estado comprobado el 22 de agosto de 2026.
• Bambuddy Spoolman documentation para las reglas de sincronización por RFID, incluido el límite de solo bobinas oficiales. Comprobado el 22 de agosto de 2026.
• SpoolmanSync y FilaMan para el puente con Home Assistant y la báscula que sirve la API de Spoolman. Comprobado el 22 de agosto de 2026.
• SimplyPrint’s Spoolman comparison para su propia descripción de Spoolman como base de datos que otro software alimenta, y de SimplyPrint como alojado y conectado a la impresora. Comprobado el 22 de agosto de 2026.
• Comportamiento de PrintStash leído del código de la v0.12.1: valores por defecto y control por superusuario en backend/app/services/runtime_config.py, la guarda de la escritura de vuelta en backend/app/services/print_results.py, y el mapeo de preajustes en un solo sentido en backend/app/services/filament_sync.py. Detalle operativo en la guía de Spoolman.
• OrcaSlicer issues #2955 y #4771, las peticiones abiertas del lado del slicer. Comprobado el 22 de agosto de 2026.