Comment installer Spoolman avec Klipper et Moonraker (Mainsail/Fluidd)

Si vous utilisez Klipper, Spoolman est la méthode standard pour arrêter de deviner combien de filament il reste sur une bobine — c'est une base de données de bobines gratuite et auto-hébergée, et Moonraker la prend en charge nativement, donc une fois branchée, Mainsail et Fluidd affichent tous les deux un sélecteur de bobine et mettent à jour le poids restant automatiquement pendant l'impression. Voici l'installation complète, de bout en bout.

Avant de commencer

• Klipper et Moonraker déjà installés et fonctionnels — Spoolman se branche sur Moonraker, il ne remplace aucune partie de votre installation existante.
• Un endroit où faire tourner le serveur Spoolman lui-même : un conteneur Docker sur le même Raspberry Pi/SBC que Moonraker, ou sur une machine séparée toujours allumée sur votre réseau (un NAS, un serveur domestique, peu importe tant que c'est allumé en permanence).
• Python 3.9+ si vous faites tourner Spoolman hors de Docker, bien que Docker soit la voie choisie par la plupart des gens puisque Spoolman fournit une image officielle.

1. Faire tourner le serveur Spoolman

La méthode officielle est Docker Compose — récupérez l'image spoolman, attribuez-lui un volume persistant pour sa base de données, et exposez un port (7912 par défaut). Une fois le conteneur lancé, vous devriez pouvoir ouvrir http://<spoolman-host>:7912 dans un navigateur et voir son interface web, vide pour l'instant.

2. Pointer Moonraker vers le serveur

Ouvrez moonraker.conf sur l'hôte de votre imprimante et ajoutez une section [spoolman] :

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

Remplacez <spoolman-host> par l'adresse IP ou le nom d'hôte où tourne le conteneur Spoolman — localhost s'il est sur la même machine que Moonraker, sinon l'IP locale du réseau.

3. Redémarrer Moonraker

sudo systemctl restart moonraker

Vérifiez dans le journal de Moonraker qu'une ligne de connexion à Spoolman apparaît sans erreur. S'il n'arrive pas à joindre le serveur, revérifiez l'adresse et assurez-vous que le port est bien accessible depuis l'hôte de l'imprimante (un simple curl http://<spoolman-host>:7912 depuis cette machine est le moyen le plus rapide de le confirmer).

4. Vérifier que ça apparaît dans Mainsail ou Fluidd

Les deux interfaces détectent automatiquement l'intégration Spoolman dès que Moonraker la signale — aucun plugin séparé à installer. Un sélecteur de bobine devrait apparaître dans le panneau de statut d'impression. S'il n'est pas encore là, un rechargement forcé de l'onglet du navigateur suffit généralement ; Moonraker n'a pas besoin d'un second redémarrage.

5. Ajouter vos bobines

Dans l'interface web de Spoolman, ajoutez un type de filament (marque, matériau, diamètre, densité), puis une bobine de ce filament avec son poids de départ. Faites-le pour chaque bobine actuellement en rotation — c'est la seule étape manuelle de toute l'installation, tout le reste se met à jour tout seul ensuite.

6. Assigner une bobine avant d'imprimer

Choisissez la bobine active dans le sélecteur que Mainsail/Fluidd affiche désormais avant de lancer une tâche. À partir de là, Moonraker signale la consommation estimée à Spoolman au fil de l'impression, et le poids restant sur cette bobine diminue automatiquement — sans balance, sans soustraction manuelle.

Ce que cela ne couvre pas

Spoolman sait désormais ce qu'il reste physiquement sur chaque bobine. Il ne vous dira pas ce qu'une impression a réellement coûté à produire, car ça n'a jamais été son rôle — pour cela, il faut réunir au même endroit le prix au kilo payé, le temps d'impression et votre tarif d'électricité. Si c'est la prochaine étape sur votre liste, voici comment Spoolman et le calcul du coût des commandes se complètent plutôt que de faire double emploi.