---
title: "Klipper: Grundlagen & Ersteinrichtung"
slug: "klipper-grundlagen-ersteinrichtung"
category: "Fortgeschritten"
difficulty: "experte"
excerpt: ""
---

## Klipper: Grundlagen & Ersteinrichtung

Klipper ist eine Open-Source-Drucker-Firmware, die auf einem Raspberry Pi (oder ähnlichem SBC) läuft und mit dem Mikrocontroller des Druckers kommuniziert. Durch die deutlich höhere Rechenleistung des Pi ermöglicht Klipper Funktionen wie Input Shaping, Pressure Advance und flexible Konfiguration per Textdatei.

### Klipper vs. Marlin — der Unterschied

| Merkmal                | Marlin                       | Klipper                              |
| ---------------------- | ---------------------------- | ------------------------------------ |
| Wo läuft die Firmware? | Direkt auf dem Drucker-Board | Raspberry Pi + kleines Board-Script  |
| Konfiguration          | C++ recompilieren nötig      | Einfache .cfg Textdatei, Live-Reload |
| Input Shaping          | Basic (MBL)                  | ADXL-basiert, sehr präzise           |
| Pressure Advance       | Linear Advance (kompliziert) | Einfach kalibrierbar                 |
| Webinterface           | Keins                        | Mainsail / Fluidd (Browser-UI)       |
| Einstieg               | Einfacher (vorinstalliert)   | Mehr Setup, mehr Lernkurve           |

### Benötigte Hardware

* **Raspberry Pi 3B+ / 4 / Zero 2W** — Pi 4 empfohlen für flüssiges UI
* **MicroSD-Karte:** 8+ GB (Class 10)
* **USB-Kabel** vom Pi zum Drucker-Board
* **Optional:** ADXL345-Beschleunigungssensor für Input Shaping

### Installation: Schritt für Schritt

1. **KIAUH installieren** (Klipper Installation And Update Helper):  
`cd ~ && git clone https://github.com/dw-0/kiauh.git && ./kiauh/kiauh.sh`
2. Im KIAUH-Menü: **1 → Install → Klipper, Moonraker, Mainsail** (in dieser Reihenfolge)
3. **Drucker-Board flashen:** In KIAUH `Build & Flash` oder manuell:  
`cd ~/klipper && make menuconfig` → Board wählen → `make` → USB-Flash
4. **printer.cfg anlegen** — Konfigurationsdatei für deinen Drucker (KIAUH hat Beispielkonfigs)
5. Mainsail im Browser öffnen: `http://<raspberry-pi-ip>`

### Welche Drucker sind kompatibel?

| Drucker             | Board                  | Klipper-Unterstützung                     |
| ------------------- | ---------------------- | ----------------------------------------- |
| Ender 3 / CR-10     | Creality 4.2.2 / 4.2.7 | Sehr gut, viele Configs verfügbar         |
| Ender 3 S1/S1 Pro   | Creality STM32         | Gut, eigenes USB-Kabel nötig              |
| Prusa MK3S/MK4      | Einsy Rambo / xBuddy   | Möglich, aber Originalfirmware oft besser |
| Voron 2.4 / Trident | BTT Octopus / Spider   | Klipper ist Standard, top Support         |
| Bambu Lab           | Proprietär             | Nicht kompatibel                          |
| Ratrig V-Core       | BTT Manta              | Klipper-First, exzellent                  |

### Die wichtigsten Klipper-Funktionen

* **Input Shaping:** ADXL345 misst Resonanzfrequenz → Klipper kompensiert automatisch Ghosting/Ringing
* **Pressure Advance:** Kompensiert Druckaufbau im Hotend → scharfe Ecken ohne Blobs
* **Macros:** G-Code-Makros für Homing, Bettausgleich, Filamentwechsel per Knopfdruck
* **Bed Mesh Leveling:** Automatisches Mesh-Bettausgleich (BLTouch/CR Touch/Klicky)
* **Exclude Objects:** Einzelne Objekte aus einem laufenden Druck herausnehmen
* **Timelapse:** Integriertes Timelapse-Plugin über Moonraker

### Mainsail vs. Fluidd

|               | Mainsail            | Fluidd                  |
| ------------- | ------------------- | ----------------------- |
| UI-Stil       | Modern, aufgeräumt  | Minimalistisch, schnell |
| Timelapse     | Eingebaut           | Plugin nötig            |
| Konfiguration | Integrierter Editor | Integrierter Editor     |
| Empfehlung    | Einsteiger          | Fortgeschrittene        |

### Erste Schritte nach der Installation

1. **PID-Kalibrierung:** `PID_CALIBRATE HEATER=extruder TARGET=200`
2. **Z-Offset einstellen:** `PROBE_CALIBRATE` (mit Probe) oder manuell
3. **Pressure Advance:** Tower-Kalibrierdruck → PA-Wert in printer.cfg setzen
4. **Input Shaping:** ADXL345 anschließen → `SHAPER_CALIBRATE` ausführen
5. **Bed Mesh:** `BED_MESH_CALIBRATE` → Profil speichern
