Como Configurar o Spoolman com Klipper e Moonraker (Mainsail/Fluidd)

Se você usa Klipper, o Spoolman é a forma padrão de parar de chutar quanto filamento resta em um carretel — é um banco de dados de carretéis gratuito e autogerenciado, e o Moonraker tem suporte nativo a ele. Assim, uma vez configurado, tanto o Mainsail quanto o Fluidd mostram um seletor de carretel e atualizam o peso restante automaticamente conforme a impressão roda. Aqui está a configuração, do início ao fim.

Antes de começar

• Klipper e Moonraker já instalados e funcionando — o Spoolman se conecta ao Moonraker, não substitui nenhuma parte da sua configuração atual.
• Um lugar para rodar o servidor do Spoolman: um container Docker no mesmo Raspberry Pi/SBC do Moonraker, ou em uma máquina separada sempre ligada na sua rede (um NAS, um servidor doméstico, qualquer coisa que fique sempre no ar).
• Python 3.9+ se for rodar o Spoolman fora do Docker, embora o Docker seja o caminho que a maioria segue, já que o Spoolman distribui uma imagem oficial.

1. Rode o servidor do Spoolman

O caminho oficial é o Docker Compose — baixe a imagem spoolman, dê a ela um volume persistente para o banco de dados e exponha uma porta (7912 por padrão). Com o container no ar, você deve conseguir abrir http://<spoolman-host>:7912 no navegador e ver a interface web dele, vazia por enquanto.

2. Aponte o Moonraker para ele

Abra o moonraker.conf no host da sua impressora e adicione uma seção [spoolman]:

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

Substitua <spoolman-host> pelo endereço IP ou hostname onde o container do Spoolman está rodando — localhost se for na mesma máquina do Moonraker, ou o IP da rede local caso contrário.

3. Reinicie o Moonraker

sudo systemctl restart moonraker

Confira o log do Moonraker em busca de uma linha de conexão com o Spoolman sem erros. Se ele não conseguir alcançar o servidor, verifique novamente o endereço e se a porta está realmente acessível a partir do host da impressora (um curl http://<spoolman-host>:7912 rápido a partir dessa máquina é a forma mais rápida de confirmar).

4. Confirme que aparece no Mainsail ou no Fluidd

As duas interfaces detectam a integração com o Spoolman automaticamente assim que o Moonraker a reporta — não é preciso instalar nenhum plugin separado. Deve aparecer um seletor de carretel no painel de status da impressão. Se ainda não aparecer, um refresh forçado na aba do navegador costuma bastar; o Moonraker não precisa de um segundo reinício.

5. Cadastre seus carretéis

Na interface web do Spoolman, cadastre um tipo de filamento (marca, material, diâmetro, densidade) e depois um carretel desse filamento com o peso inicial. Faça isso para cada carretel atualmente em uso — é a única etapa manual de toda a configuração, tudo depois disso se atualiza sozinho.

6. Selecione um carretel antes de imprimir

Escolha o carretel ativo no seletor que o Mainsail/Fluidd agora mostra antes de iniciar um trabalho. A partir daí, o Moonraker reporta o uso estimado de volta ao Spoolman conforme a impressão avança, e o peso restante daquele carretel cai automaticamente — sem balança, sem subtração manual.

O que isso não cobre

Agora o Spoolman sabe o que fisicamente resta em cada carretel. Ele não vai te dizer quanto uma impressão realmente custou para fazer, porque isso nunca foi o trabalho dele — para isso você precisa do preço por quilo que você pagou, do tempo de impressão e da sua tarifa de energia elétrica, tudo em um só lugar. Se isso é o próximo item da sua lista, veja como o Spoolman e o cálculo de custo do pedido se encaixam em vez de duplicar um ao outro.