How irbis3d/medusahc works
MedusaHC is a Klipper hotend toolchanger: the controller handles tool pickup/drop and preparation, while pin sensing can infer the mounted tool and optionally synchronize Klipper’s toolchanger and UI state. The repository also supplies printer configuration, printable mechanical assemblies, reference STEP models, and slicer profiles. Source excerpts show controller behavior and sensor dispatch; the configuration and hardware branches are documented in the README, but their internal links are not established by the sampled source.
Main entry points: pin_watch.py Pin-state monitor · medusahc.py Tool-change controller · Slicer Slicer projects · MedusaHC MedusaHC configuration
Components 19
Klipper Runtime
- Tool-change controller
klippy/extras/medusahc.py - Pin-state monitor
klippy/extras/pin_watch.py - Klipper services
- Klipper toolchanger
- Mainsail / Fluidd UI
Printer Setup
- MedusaHC configuration
config/MedusaHC - Printer examples
examples/printer-config
Mechanical System
- Dock and base parts
STLs/Base - Feeder parts
STLs/Feeder - Hotend parts
STLs/Hotend - Toolhead parts
STLs/Toolhead - Layout mounts
STLs/V-Front Mounts - V-Back mounts
STLs/V-Back Mounts - Reference assemblies
STEP
Print Workflow
- Slicer projects
Slicer - G-code post-processors
Scripts/SET_FINISH.py
Other components
- Printer operator
- MedusaHC-Calibrate
- MedusaHC Control
Connections 13
- Printer operator → Tool-change controller: requests tool change
README.md - Tool-change controller → Klipper services: runs motion commands
klippy/extras/medusahc.py - Tool-change controller → MedusaHC configuration: reads geometry settings
klippy/extras/medusahc.py - Pin-state monitor → Klipper services: registers pin callbacks
klippy/extras/pin_watch.py - Pin-state monitor → Klipper toolchanger: dispatches sync commands
klippy/extras/pin_watch.py - Pin-state monitor → Mainsail / Fluidd UI: syncs tool indicators
klippy/extras/pin_watch.py - Printer operator → MedusaHC configuration: sets up printer
README.md - Printer operator → Printer examples: adapts example configs
README.md - Printer operator → Reference assemblies: reviews reference layout
README.md - Printer operator → Slicer projects: slices tool-change jobs
README.md - Slicer projects → G-code post-processors: runs G-code processing
- Printer operator → MedusaHC-Calibrate: installs separately
README.md - Printer operator → MedusaHC Control: installs separately
README.md