Cross-platform desktop control center for Klipper printers. It discovers Moonraker-compatible printers on the local network and provides live monitoring, camera views and real printer controls.
Previous stable releases: 1.0.3, 1.0.2, 1.0.1, 1.0.0 and 0.9.8.
- Multi-printer dashboard with persistent names and per-printer accent colors
- Experimental multi-brand Moonraker discovery on ports 7125, 4408, 80, 8080, 8110 and 443
- Live temperatures, progress, estimated finish time and position
- Camera thumbnails and full camera page with automatic recovery
- Fully local YOLO11 visual monitoring for spaghetti, stringing and surface defects
- Independent AI score badges and optional confirmed automatic pause per printer
- G-code model preview from embedded slicer thumbnails
- CFS and external-spool display: material, color, remaining level, temperature and humidity
- Real speed presets through
M220 - Pause, resume, cancel and confirmed emergency stop
- Files, macros and movement controls
- Timelapse library with native Moonraker support and a dedicated local Creality K1/K2 adapter
- Integrated MP4 playback, direct downloads and storage usage
- 17 complete interface languages, including Arabic RTL
| Camera | Controls |
|---|---|
 |
 |
| Files | Macros |
|---|---|
 |
 |
| Timelapses and storage |
|---|
 |
| Settings | Emergency confirmation |
|---|---|
 |
 |
| Maintenance center |
|---|
 |
All screenshots use fictional printers and generated demo imagery. They contain no real IP address, personal filename or operating-system UI.
Download the matching installer from Releases.
- macOS: open the
.dmg, then drag HackMan3D Klipper Hub to Applications. - Windows: open the setup
.exeand follow the installer. Allow private/local-network access if Windows Firewall asks.
Your computer and printers must be on the same local network. Generic printers need an accessible Moonraker API; a printer using Klipper internally but exposing only a proprietary API may require a dedicated adapter.
- Apple Silicon: Mac with an Apple M1, M2, M3, M4 or newer processor.
- Intel: older Mac whose processor is listed as Intel in About This Mac.
- Windows x64: 64-bit Windows 10 or Windows 11.
- Move
HackMan3D Klipper Hub.appto the Applications folder. - Open the application from Applications.
- Accept the local-network request if macOS displays it.
- Approve the one-time helper installation when requested. The helper is used only as a local relay for printer and camera services.
The application stores printer names, addresses, colors and interface preferences in the current user profile. Replacing the application with a newer version does not erase these settings.
SHA-256 hashes for every official installer are published in release-checksums.txt.
English, French, Italian, Spanish, Portuguese, Chinese, German, Hindi, Arabic, Bengali, Indonesian, Russian, Japanese, Korean, Turkish, Vietnamese and Thai.
pnpm validate:localesThe validator checks all 17 languages, every UI key, dynamic placeholders and Arabic RTL support.
pnpm install
pnpm devProduction UI:
pnpm validate:locales
pnpm buildAn anonymized documentation view is available at /?demo=1.
The preferred connection is Moonraker. Automatic discovery checks common local ports, including 7125 and Creality's 4408. A printer can also be added manually with its local IP address.
The exact feature set depends on the objects, macros, webcams and storage roots exposed by the printer. The application never modifies Klipper firmware or printer.cfg during discovery.
Creality systems expose some functions through Moonraker and other functions through local Creality services. The app includes dedicated password-free LAN adapters for their cameras and timelapse catalogue:
- catalogue discovery through the printer's local WebSocket service on port
9999; - playback and downloads through the printer's local
/downloads/video/endpoint; - G-code name, video size and recording date when supplied by the printer;
- no Creality Cloud account, SSH access, certificate or firmware modification required.
Deletion remains disabled when the printer exposes a recording as read-only. This prevents the interface from pretending a deletion succeeded.
Any brand exposing a standard reachable Moonraker API can be tested. Proprietary-only functions need a brand-specific local adapter; unsupported functions are hidden or shown as unavailable instead of sending unverified commands.
Open Videos after selecting a printer. The page searches both:
- Moonraker storage roots and common video folders;
- the local Creality timelapse service on compatible K1/K2 printers.
Use Refresh after a recording has just finished. A timelapse is normally published by the printer only after it has rendered the MP4 at the end of the print.
If the page is empty:
- verify that the selected printer is online;
- confirm that the computer and printer are on the same LAN and not separated by guest Wi-Fi or client isolation;
- make sure timelapse recording is enabled on the printer;
- wait for the printer to finish rendering, then press Refresh;
- on Creality K1/K2, ensure local ports
9999and80are not blocked by a firewall.
The app first uses webcams registered in Moonraker. Version 0.9.7 includes a cross-platform local WebRTC/UDP bridge for Creality K2/K2 Plus and compatible cameras. On macOS it uses the installed privileged local-network service; on Windows it uses the embedded relay. It lets the dashboard card and main view remain visible simultaneously, uses software composition to prevent black/striped frames, and uses a padded contain layout instead of cropping the image. Activate / repair camera recreates the generated webcam entry and restarts the local path without changing the printer firmware.
Camera loading can fail when a printer is booting, Wi-Fi client isolation is enabled, another application monopolizes the stream, or the proprietary camera service has not started yet.
Visual monitoring runs locally on the computer with an embedded YOLO11 ONNX model. Camera images are not uploaded to a cloud service. Each saved printer has an independent score, sensitivity and automatic-pause setting.
- High sensitivity reports from 25% and pauses from 55%.
- Normal and low sensitivity require repeated detections.
- A black or frozen camera creates a diagnostic warning but never pauses a printer.
- A paused printer keeps its visible score but creates no further AI alerts or notifications.
- Automatic emergency stop is never used by the AI.
The detector is an assistance feature, not a guarantee. Keep the printer supervised when a failure could create a safety risk.
The application checks GitHub and can install a matching update automatically. The Stable channel follows final releases. The Beta channel follows the highest semantic version available and therefore offers a final release whenever no higher beta exists. Switching back to Stable explicitly offers the latest final build. Saved printers and preferences remain available.
Version 1.1 provides encrypted account connections for GitHub Gist and Google Drive, plus JSON export/import and versioned local backups. See docs/CLOUD_SYNC.md for the security model and provider permissions.
- Try its IP address manually. A valid example is
192.168.1.50; do not copy this example as your own address. - Keep the Moonraker port when required, for example
192.168.1.50:4408. - Disable guest-network or access-point isolation.
- Allow local-network access for the application in the operating-system privacy/firewall settings.
- Wait until the printer has completed startup, then relaunch discovery.
The printer keeps its saved card while unreachable. Confirm that its DHCP address has not changed. Assigning a DHCP reservation in the router avoids address changes after a reboot.
Klipper installations are modular. A control is available only when its related Moonraker object, macro, webcam or vendor service is present. This is intentional safety behavior.
Settings use Electron's per-user application storage, outside the app bundle. Deleting only the .app or Windows program folder therefore does not delete saved printers. Use the application's reset option when a clean configuration is required.
- Printer communication stays on the local network.
- The Creality timelapse adapter does not require a cloud login.
- The app opens GitHub only for update metadata and explicit release downloads.
- Support and social links open only when clicked.
- Screenshots in this repository use fictional printers, generated models and anonymized addresses.
Emergency stop uses Moonraker's /printer/emergency_stop endpoint. The application always displays a confirmation dialog before sending it.
Temperature, movement, extrusion, fan and speed controls send real printer commands. Review the selected printer before confirming an action. The emergency stop is reserved for dangerous motion, collision, overheating or another situation requiring immediate shutdown.
Official macOS Apple Silicon, macOS Intel and Windows x64 installers share the same application version. Before publication:
pnpm install --frozen-lockfile
pnpm validate:locales
pnpm buildThe locale validator requires the same 177 interface keys in all 17 languages, checks placeholders and verifies Arabic right-to-left support. Published SHA-256 values allow an installer to be checked independently.
HackMan3D Klipper Hub is developed and shared free of charge.