Connect Klipper printers

What you need

• A printer with Klipper and Moonraker that you operate through Mainsail or Fluidd, for example Voron, RatRig, Sovol SV08 or Qidi Plus4.
• Access to the moonraker.conf file of the printer, through the web interface.
• Spooly Pro, the trial counts.

The Snapmaker U1 works with limits, see Limits. Creality K1 and K2, Elegoo Neptune 4 and Anycubic only let you change the moonraker.conf after modifying the firmware. Spooly does not recommend that and does not create a key for them. Connect these printers under “Connected printers” in the settings.

Create a key

1. Open Spooly in the browser: Settings, Devices & keys, “Connect Klipper printer”. This does not work in the apps. “Devices & keys” exists only in the new design. If you still have the old one, switch it to “New design (beta)” under Settings, Appearance & language.
2. Give the printer a name. This is how it is named on every print in Spooly. Pick your printer type, for example “Mainsail or Fluidd”.
3. Spooly creates a key of type Klipper printer and shows you the finished block. It contains the key and appears only this one time. If you lose it, create the printer again.

A key of type Klipper printer only works at the Spoolman address. At the REST API and with an AI it does not work (403 key_kind).

Add it to the moonraker.conf

1. Open the web interface of your printer. In Mainsail it is the “Machine” section, in Fluidd “Configuration”.
2. Open the file moonraker.conf and add the block at the very end.
3. Save and restart Moonraker.

[spoolman]
server: https://spooly:spk_dein_schluessel@spooly.eu/api/spoolman
sync_rate: 5

The address is https://spooly.eu/api/spoolman. The key goes in front as the password, and the name spooly before the colon is arbitrary. You replace spk_dein_schluessel with your key, the easiest way is to copy the finished block from Spooly. sync_rate: 5 means Moonraker reports every 5 seconds.

Check

1. In Mainsail or Fluidd, pick the spool you are printing with in the “Spoolman” field on the start page. The number is the # number of the spool in Spooly.
2. In Spooly the printer is listed under Devices & keys. It shows “Connected” as soon as Moonraker has the connection open. Before that it says “Waiting for the printer”.
3. Start a print. With the first usage report Spooly creates the print, source Klipper, printer is the name from step 2. The remaining weight of the spool drops while it prints.

If Moonraker reports nothing for 15 minutes, the print counts as finished. You see the history in the printer row under “Latest prints”.

Limits

• Moonraker always reports for the spool you picked in Mainsail or Fluidd. Change it before the print starts.
• At most 3,000 g per report, and for a length at most 1,000,000 mm. Spooly does not book larger or invalid values, the report itself still answers 200.
• At most 60 reports a minute per key. Moonraker sends at most 12. Above that, Spooly answers 429 with Retry-After, and Moonraker sends the amount later.
• Usage reports and the open connection do not count toward the 10,000 calls a day.
• If the chosen spool does not exist in your account, Spooly answers 404. Moonraker then discards the amount and forgets the active spool. Archived spools work.
• When Pro expires, Spooly books nothing until Pro is active again (402).
• If the Spooly Bridge or the home network feature of the app already runs for this printer, remove it there. Otherwise every print arrives twice, and Spooly puts the second one into the review queue.
• Snapmaker U1: Advanced Mode has to stay on, and a firmware update will probably delete the entry. Spooly counts only one spool per print and does not split multicolor prints. The Spooly Bridge counts all four heads.
• Errors at the Spoolman address come as {"message":"..."} with a German text, not in the format of the REST API. Error codes

Protect the key

If it got into the wrong hands, revoke it under Settings, Devices & keys and create the printer again.

If something does not work