How arksine/moonraker works
Moonraker is a Python API server that lets client applications inspect and control Klipper-based 3D printers. Clients make HTTP or WebSocket requests; the server routes API/RPC calls to printer, file, job, and system components, which interact with Klipper, persistent state, or host services. The tree and excerpts support the server, transport, file-management, database, and update-management roles shown here. Other product capabilities are represented by their named component paths; their internal wiring was not sampled, so uncertain connections are omitted.
Main entry points: application.py HTTP handlers · file_manager.py File manager · server.py Server lifecycle · klippy_connection.py Klippy connection
Components 24
API and server
- Server lifecycle
moonraker/server.py - HTTP handlers
moonraker/components/application.py - JSON-RPC
moonraker/common.py - WebSocket transport
moonraker/components/websockets.py - Authorization
moonraker/components/authorization.py
Printer workflow
- Klippy connection
moonraker/components/klippy_connection.py - Klippy APIs
moonraker/components/klippy_apis.py - Job state
moonraker/components/job_state.py - Print history
moonraker/components/history.py - Print analysis
moonraker/components/analysis.py
Files and jobs
- File manager
moonraker/components/file_manager/file_manager.py - G-code metadata
moonraker/components/file_manager/metadata.py - Job queue
moonraker/components/job_queue.py - SQLite database
moonraker/components/database.py
Host management
- Machine services
moonraker/components/machine.py - Power control
moonraker/components/power.py - Update manager
moonraker/components/update_manager/update_manager.py - Git deployment
moonraker/components/update_manager/git_deploy.py
Extensions and services
- Announcements
moonraker/components/announcements.py - Notifications
moonraker/components/notifier.py - MQTT integration
moonraker/components/mqtt.py
Other components
- Client applications
- Klipper firmware
- Host operating system
Connections 16
- Client applications → HTTP handlers: sends requests
- HTTP handlers → Authorization: checks access
- HTTP handlers → JSON-RPC: dispatches RPC
- HTTP handlers → File manager: uploads files
- Server lifecycle → WebSocket transport: loads transport
- Server lifecycle → HTTP handlers: registers handlers
- Klippy APIs → Klippy connection: uses connection
- Klippy connection → Klipper firmware: communicates
- Job state → Print history: records jobs
- File manager → G-code metadata: parses metadata
- File manager → SQLite database: stores metadata
- Job queue → SQLite database: persists queue
- Update manager → Git deployment: runs deployment
- Git deployment → Host operating system: updates software
- Machine services → Host operating system: queries host
- Power control → Host operating system: controls devices