Quelle: https://spooly.eu/docs/klipper

# Klipper-Drucker verbinden

Klipper-Drucker melden ihren Verbrauch über Moonraker direkt an Spooly, so wie sonst an einen Spoolman-Server. Du fügst einen Block in die `moonraker.conf` ein und wählst in Mainsail oder Fluidd die aktive Spule. Spooly bucht danach jeden Druck.

- Schlüsselart: Klipper-Drucker (`klipper`)
- Adresse: `https://spooly.eu/api/spoolman`
- Voraussetzung: Moonraker, Spooly Pro

> Beta: Die Schnittstelle ist gerade nur für freigeschaltete Konten offen. Schreib mir kurz, was du vorhast. Oder schreib an support@spooly.eu.

## Was du brauchst

- Einen Drucker mit Klipper und Moonraker, den du über Mainsail oder Fluidd bedienst, zum Beispiel Voron, RatRig, Sovol SV08 oder Qidi Plus4.
- Zugriff auf die Datei `moonraker.conf` des Druckers, über die Weboberfläche.
- Spooly Pro, der Trial zählt mit.

Der Snapmaker U1 geht eingeschränkt, siehe [Grenzen](https://spooly.eu/docs/klipper#klipper-grenzen). Creality K1 und K2, Elegoo Neptune 4 und Anycubic lassen die `moonraker.conf` nur nach einem Eingriff in die Firmware ändern. Spooly empfiehlt das nicht und legt dafür keinen Schlüssel an. Verbinde diese Drucker unter „Verbundene Drucker“ in den Einstellungen.

## Schlüssel anlegen

1. Öffne Spooly im Browser: Einstellungen, Geräte & Schlüssel, „Klipper-Drucker verbinden“. In den Apps geht das nicht. „Geräte & Schlüssel“ gibt es nur im neuen Design. Hast du noch das alte, schaltest du es unter Einstellungen, Darstellung & Sprache auf „Neues Design (Beta)“ um.
2. Gib dem Drucker einen Namen. So heißt er an jedem Druck in Spooly. Wähl deine Druckerart, zum Beispiel „Mainsail oder Fluidd“.
3. Spooly legt einen Schlüssel der Art Klipper-Drucker an und zeigt dir den fertigen Block. Er enthält den Schlüssel und erscheint nur dieses eine Mal. Verloren heißt: den Drucker neu anlegen.

Der Schlüssel der Art Klipper-Drucker gilt nur an der Spoolman-Adresse. An der [REST-API](https://spooly.eu/docs/api) und bei der KI funktioniert er nicht (403 `key_kind`).

## In die moonraker.conf eintragen

1. Öffne die Weboberfläche deines Druckers. In Mainsail ist es der Bereich „Maschine“, in Fluidd „Konfiguration“.
2. Öffne die Datei `moonraker.conf` und füg den Block ganz am Ende ein.
3. Speichere und starte Moonraker neu.

moonraker.conf:

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

Die Adresse ist `https://spooly.eu/api/spoolman`. Der Schlüssel steht als Passwort davor, der Name `spooly` vor dem Doppelpunkt ist beliebig. `spk_dein_schluessel` ersetzt du durch deinen Schlüssel, am einfachsten kopierst du den fertigen Block aus Spooly. `sync_rate: 5` heißt, Moonraker meldet alle 5 Sekunden.

## Prüfen

1. Wähl in Mainsail oder Fluidd auf der Startseite im Feld „Spoolman“ die Spule, mit der du druckst. Die Nummer ist die `#`-Nummer der Spule in Spooly.
2. In Spooly steht der Drucker unter Geräte & Schlüssel. Er zeigt „Verbunden“, sobald Moonraker die Verbindung offen hat. Davor steht dort „Wartet auf den Drucker“.
3. Starte einen Druck. Mit der ersten Verbrauchsmeldung legt Spooly den Druck an, Quelle Klipper, Drucker ist der Name aus Schritt 2. Das Restgewicht der Spule sinkt, während gedruckt wird.

Meldet Moonraker 15 Minuten lang nichts, gilt der Druck als beendet. Den Verlauf siehst du in der Zeile des Druckers unter „Letzte Drucke“.

## Grenzen

- Moonraker meldet immer für die Spule, die du in Mainsail oder Fluidd gewählt hast. Wechsle sie, bevor der Druck beginnt.
- Höchstens 3.000 g je Meldung, bei einer Länge höchstens 1.000.000 mm. Größere oder ungültige Werte bucht Spooly nicht, die Meldung selbst antwortet trotzdem 200.
- Höchstens 60 Meldungen in der Minute je Schlüssel. Moonraker schickt höchstens 12. Darüber antwortet Spooly mit 429 und Retry-After, Moonraker schickt die Menge später nach.
- Verbrauchsmeldungen und die offene Verbindung zählen nicht zu den 10.000 [Aufrufen am Tag](https://spooly.eu/docs/limits).
- Gibt es die gewählte Spule in deinem Konto nicht, antwortet Spooly mit 404. Moonraker verwirft dann die Menge und vergisst die aktive Spule. Archivierte Spulen gehen.
- Läuft Pro ab, bucht Spooly nichts, bis Pro wieder aktiv ist (402).
- Läuft die Spooly Bridge oder das Heimnetz der App schon für diesen Drucker, entferne sie dort. Sonst kommt jeder Druck zweimal an, und Spooly legt den zweiten in die Nachkontrolle.
- Snapmaker U1: Der Advanced Mode muss eingeschaltet bleiben, und ein Firmware-Update löscht den Eintrag wahrscheinlich. Spooly zählt je Druck nur eine Spule und trennt Mehrfarbdrucke nicht. Alle vier Köpfe zählt die Spooly Bridge.
- Fehler an der Spoolman-Adresse kommen als `{"message":"..."}` mit deutschem Text, nicht im Format der REST-API. [Fehlercodes](https://spooly.eu/docs/errors)

## Schlüssel schützen

> Der Schlüssel steht im Klartext auf dem Drucker: Gib die `moonraker.conf` nicht weiter und zeig sie nicht in Fotos oder Foren. Stell Mainsail, Fluidd und Moonraker nicht ungeschützt ins Internet. Wer den Schlüssel hat, kann dein Inventar lesen und Verbrauch melden. Mehr kann er damit nicht.

Ist er in falsche Hände geraten, widerruf ihn unter Einstellungen, Geräte & Schlüssel und leg den Drucker neu an.

## Wenn etwas nicht klappt

| Zeichen | Was du tust |
| --- | --- |
| Der Drucker bleibt bei „Wartet auf den Drucker“ | Prüf, ob der Block am Ende der `moonraker.conf` steht, die Adresse stimmt und du Moonraker neu gestartet hast. |
| 401 | Der Schlüssel ist falsch oder widerrufen. Leg den Drucker in Spooly neu an. |
| 402 | Pro ist abgelaufen. Spooly bucht wieder, sobald Pro aktiv ist. |
| 403 | Die API ist für dein Konto noch nicht freigeschaltet, oder der Schlüssel hat nicht die Art Klipper-Drucker. |
| 404 | Die gewählte Spule gibt es in deinem Konto nicht. Wähl eine andere. |
| 429 | Zu viele Meldungen oder zu viele gleichzeitige Anfragen. Moonraker versucht es selbst noch einmal. |