claudeers.
// Claude Plugins

ender3v2-klipper

Ender 3 V2 from Marlin to Klipper on a Raspberry Pi, a Linux PC or a Mac (UTM VM, no Pi): install, full calibration, go/no-go gate, monitoring and power-loss…

Actively maintained
91/100
last commit about 1 month ago
last release none
releases 0
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up ender3v2-klipper (claude-plugin project) into my current project.
Found on https://claudeers.com/ender3v2-klipper
Repo: https://github.com/oscarolar/ender3v2-klipper
Homepage/docs: —
Detected install method: claude-plugin → /plugin install ender3v2-klipper@oscarolar/ender3v2-klipper
Category: plugins. Platforms: api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add oscarolar/ender3v2-klipper
/plugin install ender3v2-klipper@oscarolar/ender3v2-klipper
// or clone
git clone https://github.com/oscarolar/ender3v2-klipper

// compatibility

Platformsapi
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Ender 3 V2: Marlin to Klipper on any host

Move a Creality Ender 3 V2 to Klipper on whatever machine is always on:

  • a Raspberry Pi (Raspberry Pi OS Lite 64-bit) or any Linux PC/server (Debian 12+, Ubuntu 22.04+) with the printer's USB plugged in, or
  • an Apple Silicon Mac with no Linux machine around: the Klipper host (Klipper, Moonraker, Mainsail) runs in a headless Debian VM under UTM and a small bridge forwards the USB serial to it over TCP.

This repository is a Claude Code plugin: a skill that walks an agent (and you) through the whole migration from Marlin, a full calibration, a go/no-go test and life afterwards (watching long prints, resuming after a stop), plus the scripts and configs it uses. Everything can also be followed by hand. It was called ender3v2-klipper-on-mac until v0.2.0.

Results on one printer

Stock Ender 3 V2 (board 4.2.2, bowden extruder, CR Touch clone, carborundum glass bed), mainline Klipper on a Mac mini VM over the bridge:

Before (Marlin)After (Klipper)
Go/no-go print (~3 h, dense retractions)—0 Timer too close, 0 lost communication, bytes_invalid 0
Bed mesh range, 180 × 210 mm0.82 mm (UBL)0.205 mm
Probe repeatability (PROBE_ACCURACY std dev)—0.0075 mm
A bust, same slicer4 h 05 (stock Orca process)1 h 51 (fast process), 2.2× faster
PLA first layer—sticks to the stock glass without glue

The mesh gain came mostly from fixing the X gantry and tramming properly; Klipper made that measurable.

How it works

 Raspberry Pi / Linux PC                 Mac
 CH340 --udev--> /dev/printer            CH340 -> klipper-serial-bridge.py (LaunchAgent)
                  |                               TCP 192.168.64.1:7523 --host-only-->
                  v                      Debian VM (UTM): socat -> /dev/printer
         Klipper + Moonraker + Mainsail           -> Klipper + Moonraker + Mainsail

The same printer.cfg works on every host: Klipper reads /dev/printer, which exists only after the cutover (printer-link.sh enable), so Klipper never grabs the printer while it still runs Marlin. Why a VM and a bridge on the Mac rather than Docker or USB passthrough: docs/adr/0001; why one setup for every host: docs/adr/0002.

Install as a Claude Code plugin

claude plugin marketplace add oscarolar/ender3v2-klipper
claude plugin install ender3v2-klipper@ender3v2-klipper

Already had ender3v2-klipper-on-mac installed? Remove it first: claude plugin uninstall ender3v2-klipper-on-mac@ender3v2-klipper-on-mac and claude plugin marketplace remove ender3v2-klipper-on-mac.

Then ask Claude something like "move my Ender 3 V2 to Klipper on my Raspberry Pi" (or "on this Mac"). The skill keeps your printer on Marlin until the host is proven, asks you for physical feedback only (paper feel, knob turns, tower heights), and reads every result as numbers from Moonraker.

Follow it by hand

Start at SKILL.md, then the references in order:

  1. host-setup.md (on a Mac first host-mac-vm-bridge.md)
  2. firmware-and-cutover.md and printer-config.md
  3. calibration.md, print-start-and-probe.md, slicer-orca.md
  4. go-no-go-and-rollback.md
  5. power-loss-and-monitoring.md, upgrades.md

troubleshooting.md when stuck.

What is in files/

PathWhat
host/runs on the Klipper host: install-stack.sh (SERIAL_MODE=usb or bridge), printer-link.sh (cutover/rollback), systemd units, udev rule, nginx site
mac/Mac only: create-vm.sh + vm-seed/ (cloud-init), the USB ↔ TCP klipper-serial-bridge.py, LaunchAgents (install-agents.sh)
firmware/ender3v2-422.configKlipper firmware build config for the 4.2.2 board
klipper/printer.cfg, macros.cfg (PRINT_START, PRINT_END, power-loss resume), moonraker.conf
orca/OrcaSlicer printer + fast process profile generator (macOS, Linux, Windows)
calibration/retraction towers and 5-disc adhesion STLs, and the generator for other sizes (PA and ringing towers come with Klipper)
tools/deploy-config.sh, Moonraker helper, print monitor, auto-resume, resume-point mirror, jitter probe

Hosts, IPs, labels and paths are settings with defaults; each script documents its variables in its header.

Tests

uvx --with pyserial pytest -q tests

Covers the serial bridge (with pyserial's loop://), the Orca profile generator, the calibration models, the auto-resume decisions, the resume-point mirror and the print monitor against a fake Moonraker. Klipper batch-mode tests of the macros are not included: they need a Klipper checkout and a built firmware dictionary.

Limitations

  • Proven on one printer, over the Mac path: Ender 3 V2, board 4.2.2, stock bowden, a CR Touch clone, a Mac mini M1 with UTM 4.7 and Debian 12. The Pi and Linux paths are Klipper's standard direct-USB setup driven by the same scripts, but have not had their own go/no-go print here yet. Other boards (4.2.7), probes or extruders need their own pins and numbers.
  • The host is now part of the printer: a reboot, suspend or crash stops the print (heaters off). Power-loss resume (PLR_RESUME) is best effort.
  • On a Mac, homing and probing need App Nap off, an interactive-priority bridge and a one-line Klipper patch (TRSYNC_TIMEOUT 25 → 50 ms) that every Klipper update reverts until install-stack.sh is re-run; and the Mac must not run iCloud Contacts/Photos sync or iPhone calls, which froze the VM every hour.
  • The stock DWIN display goes dark; you control the printer from Mainsail.
  • No accelerometer: input shaping is chosen from a printed ringing tower.
  • A CR Touch clone can still latch at print start; the only fix is a printer power cycle. The start macro reduces how often it happens, it does not remove it.
  • Nothing here is endorsed by Creality, Klipper, UTM, Raspberry Pi or OrcaSlicer.

License

MIT, see LICENSE.

// faq

What is ender3v2-klipper?

Ender 3 V2 from Marlin to Klipper on a Raspberry Pi, a Linux PC or a Mac (UTM VM, no Pi): install, full calibration, go/no-go gate, monitoring and power-loss resume, as a Claude Code skill. It is open-source on GitHub.

Is ender3v2-klipper free to use?

ender3v2-klipper is open-source under the MIT license, so it is free to use.

What category does ender3v2-klipper belong to?

ender3v2-klipper is listed under plugins in the Claudeers registry of Claude-compatible tools.

8 views
★ 12 stars
unclaimed
updated about 1 month ago

// embed badge

ender3v2-klipper on Claudeers
[![Claudeers](https://claudeers.com/api/badge/ender3v2-klipper.svg)](https://claudeers.com/ender3v2-klipper)

// retro hit counter

ender3v2-klipper hit counter
[![Hits](https://claudeers.com/api/counter/ender3v2-klipper.svg)](https://claudeers.com/ender3v2-klipper)

// reviews

// guestbook

0/500

// related in Claude Plugins

🔓

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/★ 230,631[ claude ]
🔓

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…

// pluginsanthropics/⟨Python⟩★ 156,472[ claude ]
🔓

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨Python⟩★ 58,467◷ Apache-2.0[ claude ]
🔓

financial-services — a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨Python⟩★ 41,409◷ Apache-2.0[ claude ]
→ see how ender3v2-klipper connects across the ecosystem