grotti/docs/internal/Glossar.md

Glossar: Moonraker, Mainsail und der Rest

Stand 15.10.2026. Begriffe rund um Kobra 3 / S1, Rinkhals und Grotti. Architektur-Details: Anycubic-Stack.

Die Schichten in einem Satz

Schicht	Rolle
MCU-Firmware	Läuft auf der Drucker-Platine: Stepper, Heizer, Sensoren.
gklib (GoKlipper)	„Gehirn“ auf dem Linux der Kobra — Anycubics Go-Port von Klipper.
gkapi	Anycubic-Dienst: MQTT, Cloud/LAN, Druck-Tasks, Touch-Anbindung.
Moonraker	HTTP/WebSocket-API vor gklib — das, was Apps und Grotti ansprechen.
Mainsail / Fluidd	Web-Oberflächen auf Moonraker (Live-Steuerung, Konsole).
Grotti	Eure lokale Farm-Seite: Queue, Wand, Material, Abräumen — spricht Moonraker (+ MQTT wo nötig).
Rinkhals	Community-Aufsatz auf der Stock-Firmware: bringt Moonraker, SSH, Apps.

flowchart TB
  UI[Mainsail / Fluidd / Grotti / Orca]
  UI --> MR[Moonraker]
  UI -.->|Start mit ACE/Bettnetz, Stop| MQTT[gkapi MQTT]
  MR --> GK[gklib GoKlipper]
  MQTT --> GK
  Touch[K3SysUi Touch] --> MQTT
  GK --> MCU[MCU]
  GK --> ACE[ACE]

A–Z

ACE

Anycubic Color Engine — Multimaterial-Box (vier Plätze). Ansteuerung in gklib (ACE_*-G-codes); Zuordnung Farbe→Platz oft über Sidecar .acm und/oder MQTT ams_settings. In Moonraker erscheint das bei Rinkhals oft als Objekt mmu (gate_color, …).

Fluidd

Web-UI für Klipper/Moonraker, Alternative zu Mainsail. Gleiche API, anderes Aussehen. Bei Rinkhals typisch Port 4408.

FIRMWARE_RESTART

Klipper-Befehl: Host + MCU neu laden. Auf GoKlipper deadlockt gklib oft (Rinkhals #32). Grotti und Rinkhals lehnen ihn ab → Display-Reboot oder Strom.

gklib / GoKlipper

Anycubics Klipper-Host in Go (Open Source: Klipper-go). Entspricht grob dem klassischen klippy. Dateiname auf dem Drucker: gklib.

gkapi

Geschlossener Anycubic-Dienst neben gklib. Betreibt den lokalen MQTT-Broker, Druck-Tasks, Credentials (:18910), Anbindung Touch/Cloud. Hier sitzt der Task, der bei Abbruch 10101 verursacht, wenn nur Moonraker-cancel kommt.

Grotti

Dieses Tool: lokale deutsche Seite für mehrere Moonraker-Drucker — Wand, Warteschlange „wenn frei“, Abräumen (Kobra 3), Material, Kosten, Telegram. Kein Slicer, keine Cloud.

K3SysUi

Anycubic-Touch-Oberfläche (geschlossen). Rinkhals patcht sie, um das eigene Menü einzuhängen.

Klipper

Open-Source-Firmware-Architektur: schwere Berechnung auf dem Host (Linux), MCU führt Bewegungen aus. Vanilla-Klipper ist Python (klippy); auf der Kobra 3 läuft die Go-Variante.

Mainsail

Beliebte Web-UI für Moonraker: Status, Temp, G-code-Konsole, Dateien, Webcam. Bei Rinkhals oft Port 80 / 4409. Fühlt sich „direkter“ an als Grotti, weil die Konsole offen ist.

Moonraker

API-Server vor Klipper/gklib: HTTP und WebSocket. Upload, print/start, Pause, gcode/script, objects/query, Kamera-Proxy. OctoPrint-Äquivalent in der Klipper-Welt. Grotti und Mainsail sind Clients davon — Moonraker ist nicht die schöne Oberfläche selbst.

MQTT (hier)

Protokoll zu gkapi, nicht zu Moonraker. Topics wie …/slicer/printer/{modelId}/{deviceId}/print. Genutzt für Druck start/stop, Info-Query, optional Temp/Speed/Licht. Ports: lokal oft 2883, von außen TLS 9883.

OctoPrint

Klassische Host-Software für (meist) Marlin-Drucker: Web-UI, Plugins, oft G-code-Streaming Zeile für Zeile. Bei Klipper/Rinkhals ersetzt durch Moonraker + Mainsail/Fluidd (Datei komplett hochladen, Host spielt ab).

Orca / AnycubicSlicerNext

Slicer auf dem PC. Schicken fertige .gcode per Moonraker (oder USB). Kein Teil der Drucker-Firmware.

printer.cfg / printer.generated.cfg

Klipper-Konfiguration. Auf Anycubic oft generiert/neu geschrieben; Rinkhals warnt vor wildem Editieren (Boot-Risiko). Z-Offset u. a. in printer_mutable.cfg.

Repetier-Server

Host-Software ähnlich OctoPrint (eigene UI, oft Streaming/direktes G-code). Gleicher Kontrast: auf der Kobra ist der Host gklib, die API Moonraker.

Rinkhals

Community-Overlay auf Stock-Kobra-OS: Moonraker, Mainsail/Fluidd, SSH, App-Store, ohne die Stock-Firmware zu ersetzen. Installiert der Nutzer selbst (SWU). Docs: rinkhals-community/Rinkhals.

SSH

Root-Shell auf dem Drucker-Linux (Rinkhals: Port 22, root / rockchip). Zum Debuggen, Logs, App-Properties — nicht der normale Weg für Drucksteuerung (das bleibt Moonraker).

SWU

Anycubic-Update-Paket auf USB (Ordner aGVscF9zb3Nf). Darüber kommen Stock-Updates und Rinkhals/Installer.

virtual_sdcard

Klipper-Modul: G-code liegt als Datei auf dem Host und wird von gklib abgespielt. Deshalb Upload + Start statt Streaming über WLAN.

10101

Anycubic-MQTT-Fehler: „Druck-Task existiert schon“. Typisch nach Abbruch nur über Moonraker, ohne MQTT action: stop.