Come configurare Spoolman con Klipper e Moonraker (Mainsail/Fluidd)

Se usi Klipper, Spoolman è il modo standard per smettere di indovinare quanto filamento resta su una bobina — è un database di bobine gratuito e self-hosted, e Moonraker lo supporta nativamente, quindi una volta collegato, sia Mainsail che Fluidd mostrano un selettore di bobine e aggiornano automaticamente il peso rimanente mentre la stampa procede. Ecco la configurazione, dall'inizio alla fine.

Prima di iniziare

• Klipper e Moonraker già installati e funzionanti — Spoolman si collega a Moonraker, non sostituisce nessuna parte della configurazione esistente.
• Un posto dove far girare il server Spoolman stesso: un container Docker sullo stesso Raspberry Pi/SBC di Moonraker, oppure su una macchina separata sempre accesa sulla tua rete (un NAS, un server domestico, qualsiasi cosa resti sempre attiva).
• Python 3.9+ se esegui Spoolman fuori da Docker, anche se Docker è la strada scelta dalla maggior parte delle persone, dato che Spoolman fornisce un'immagine ufficiale.

1. Avvia il server Spoolman

La strada ufficiale è Docker Compose — scarica l'immagine spoolman, assegnale un volume persistente per il suo database ed esponi una porta (7912 di default). Una volta avviato il container, dovresti riuscire ad aprire http://<spoolman-host>:7912 in un browser e vedere la sua interfaccia web, per ora vuota.

2. Punta Moonraker verso di esso

Apri moonraker.conf sull'host della tua stampante e aggiungi una sezione [spoolman]:

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

Sostituisci <spoolman-host> con l'indirizzo IP o l'hostname dove gira il container Spoolman — localhost se è sulla stessa macchina di Moonraker, altrimenti l'IP della rete locale.

3. Riavvia Moonraker

sudo systemctl restart moonraker

Controlla il log di Moonraker per una riga di connessione a Spoolman senza errori. Se non riesce a raggiungere il server, ricontrolla l'indirizzo e che la porta sia effettivamente raggiungibile dall'host della stampante (un rapido curl http://<spoolman-host>:7912 da quella macchina è il modo più veloce per verificarlo).

4. Verifica che compaia in Mainsail o Fluidd

Entrambe le interfacce rilevano automaticamente l'integrazione con Spoolman non appena Moonraker la segnala — non serve installare alcun plugin separato. Dovresti vedere comparire un selettore di bobine nel pannello di stato della stampa. Se non è ancora presente, di solito basta un refresh forzato della scheda del browser; Moonraker non richiede un secondo riavvio.

5. Aggiungi le tue bobine

Nell'interfaccia web di Spoolman, aggiungi un tipo di filamento (marca, materiale, diametro, densità) e poi una bobina di quel filamento con il suo peso iniziale. Fallo per ogni bobina attualmente in uso — è l'unico passaggio manuale di tutta la configurazione, tutto il resto da qui in poi si aggiorna da solo.

6. Assegna una bobina prima di stampare

Scegli la bobina attiva dal selettore che Mainsail/Fluidd ora mostra prima di avviare un lavoro. Da qui in avanti, Moonraker segnala a Spoolman l'uso stimato man mano che la stampa procede, e il peso rimanente su quella bobina si riduce automaticamente — nessuna bilancia, nessuna sottrazione manuale.

Cosa non copre questa guida

Ora Spoolman sa cosa resta fisicamente su ogni bobina. Non ti dirà quanto è costata davvero una stampa, perché non è mai stato il suo compito — per questo ti servono in un unico posto il prezzo al chilo che hai pagato, il tempo di stampa e la tua tariffa elettrica. Se è questo il prossimo passo, ecco come Spoolman e il calcolo dei costi degli ordini si integrano invece di duplicarsi a vicenda.