# treed-hub/printer-core architecture

> Architecture diagram of the GitHub repository treed-hub/printer-core, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/treed-hub/printer-core
- Repository: https://github.com/treed-hub/printer-core

## Overview

TreeD Printer Core provisions and maintains a supported TreeD V2 printer runtime, then supplies its Klipper/Moonraker behavior and operator-facing interfaces. The main workflow runs from bootstrap and loader provisioning through printer configuration and firmware-target preparation to Klipper print execution; operators also manage the printer through UI and Moonraker services. The graph preserves documented update, recovery, network, filament, camera, and display capabilities. Most subsystem wiring is documented in the README; unsampled implementation details are not inferred.

Main entry points: [`runtime-scripts/treed-ui/treed-ui`](https://github.com/treed-hub/printer-core/blob/treed-v2/runtime-scripts/treed-ui/treed-ui) (TreeD Shell), [`moonraker`](https://github.com/treed-hub/printer-core/tree/treed-v2/moonraker) (Moonraker Config), [`loader/loader.sh`](https://github.com/treed-hub/printer-core/blob/treed-v2/loader/loader.sh) (Loader), [`klipper-host`](https://github.com/treed-hub/printer-core/tree/treed-v2/klipper-host) (Klipper Extensions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provision["Provisioning"]
  node_bootstrap["Bootstrap<br/>[bootstrap-pi.sh]"]
  node_loader["Loader<br/>[loader.sh]"]
  node_loadersteps["Provision Steps"]
end

subgraph group_printer["Printer Runtime"]
  node_runtimeconfig["Runtime Config"]
  node_macros["Print Macros"]
  node_hostextensions["Klipper Extensions"]
  node_drivers["Driver Modes"]
  node_sgt["SGT Calibration"]
  node_zrecovery["Z Recovery"]
end

subgraph group_services["Host Services"]
  node_moonconfig["Moonraker Config"]
  node_update["Core and UI Update<br/>[treed_update.py]"]
  node_recovery["Host Recovery<br/>[treed_recovery.py]"]
  node_network["Wi-Fi Management"]
  node_filament["Filament Settings"]
  node_detection["Printer Detection<br/>[treed_detection.py]"]
  node_camera["Camera Diagnostics<br/>[stream_detect.py]"]
end

subgraph group_interfaces["Operator Interfaces"]
  node_ui["TreeD Shell"]
  node_mainsail["Mainsail UI"]
  node_screen["KlipperScreen Theme"]
  node_events["Printer Events<br/>[printer-events.md]"]
end

subgraph group_hardware["Hardware Targets"]
  node_firmware["Firmware Targets"]
  node_printerhardware{{"V2 Hardware"}}
end

node_operator(("Operator"))

node_operator -->|"installs"| node_bootstrap
node_bootstrap -->|"starts"| node_loader
node_loader -->|"runs steps"| node_loadersteps
node_loader -->|"stages configs"| node_runtimeconfig
node_loader -->|"builds targets"| node_firmware
node_runtimeconfig -->|"defines print flow"| node_macros
node_macros -->|"controls printing"| node_printerhardware
node_hostextensions -->|"extends control"| node_printerhardware
node_drivers -->|"provides mode control"| node_hostextensions
node_sgt -->|"provides calibration"| node_hostextensions
node_zrecovery -->|"provides Z recovery"| node_hostextensions
node_firmware -->|"targets"| node_printerhardware
node_operator -->|"manages"| node_ui
node_ui -->|"requests updates"| node_update
node_ui -->|"manages Wi-Fi"| node_network
node_ui -->|"sets sensitivity"| node_filament
node_ui -.->|"requests recovery"| node_recovery
node_moonconfig -.->|"configures"| node_update
node_moonconfig -.->|"configures"| node_network
node_moonconfig -.->|"configures"| node_recovery
node_moonconfig -.->|"configures"| node_filament
node_mainsail -.->|"operates printer"| node_printerhardware
node_screen -.->|"displays status"| node_printerhardware
node_printerhardware -->|"publishes events"| node_events
node_events -->|"drives notifications"| node_ui
node_events -->|"exposes stream"| node_mainsail
node_operator -->|"runs diagnostics"| node_camera
node_detection -.->|"reports status"| node_printerhardware

click node_bootstrap "https://github.com/treed-hub/printer-core/blob/treed-v2/bootstrap-pi.sh"
click node_loader "https://github.com/treed-hub/printer-core/blob/treed-v2/loader/loader.sh"
click node_loadersteps "https://github.com/treed-hub/printer-core/tree/treed-v2/loader/steps"
click node_runtimeconfig "https://github.com/treed-hub/printer-core/tree/treed-v2/klipper/profiles/treed_v2_corexy_v1"
click node_macros "https://github.com/treed-hub/printer-core/blob/treed-v2/klipper/profiles/treed_v2_corexy_v1/macros_print_flow.cfg"
click node_hostextensions "https://github.com/treed-hub/printer-core/tree/treed-v2/klipper-host"
click node_drivers "https://github.com/treed-hub/printer-core/blob/treed-v2/klipper-host/treed_driver_mode.py"
click node_sgt "https://github.com/treed-hub/printer-core/blob/treed-v2/klipper-host/treed_sgt_executor.py"
click node_zrecovery "https://github.com/treed-hub/printer-core/blob/treed-v2/klipper-host/treed_z_recovery.py"
click node_moonconfig "https://github.com/treed-hub/printer-core/tree/treed-v2/moonraker"
click node_update "https://github.com/treed-hub/printer-core/blob/treed-v2/moonraker/components/treed_update.py"
click node_recovery "https://github.com/treed-hub/printer-core/blob/treed-v2/moonraker/components/treed_recovery.py"
click node_network "https://github.com/treed-hub/printer-core/blob/treed-v2/moonraker/components/treed_host_network.py"
click node_filament "https://github.com/treed-hub/printer-core/blob/treed-v2/moonraker/components/treed_filament_sensor.py"
click node_detection "https://github.com/treed-hub/printer-core/blob/treed-v2/moonraker/components/treed_detection.py"
click node_camera "https://github.com/treed-hub/printer-core/blob/treed-v2/runtime-scripts/treed-cam/stream_detect.py"
click node_ui "https://github.com/treed-hub/printer-core/blob/treed-v2/runtime-scripts/treed-ui/treed-ui"
click node_mainsail "https://github.com/treed-hub/printer-core/tree/treed-v2/mainsail"
click node_screen "https://github.com/treed-hub/printer-core/tree/treed-v2/klipperscreen/themes/treed-oled"
click node_events "https://github.com/treed-hub/printer-core/blob/treed-v2/contracts/printer-events.md"
click node_firmware "https://github.com/treed-hub/printer-core/tree/treed-v2/firmware/configs/treed_v2"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_bootstrap,node_loader,node_loadersteps toneBlue
class node_runtimeconfig,node_macros,node_hostextensions,node_drivers,node_sgt,node_zrecovery toneAmber
class node_moonconfig,node_update,node_recovery,node_network,node_filament,node_detection,node_camera toneMint
class node_ui,node_mainsail,node_screen,node_events toneRose
class node_firmware,node_printerhardware,node_operator toneIndigo
```

## Components

### Provisioning

- [Bootstrap](https://github.com/treed-hub/printer-core/blob/treed-v2/bootstrap-pi.sh): `bootstrap-pi.sh`
- [Loader](https://github.com/treed-hub/printer-core/blob/treed-v2/loader/loader.sh): `loader/loader.sh`
- [Provision Steps](https://github.com/treed-hub/printer-core/tree/treed-v2/loader/steps): `loader/steps`

### Printer Runtime

- [Runtime Config](https://github.com/treed-hub/printer-core/tree/treed-v2/klipper/profiles/treed_v2_corexy_v1): `klipper/profiles/treed_v2_corexy_v1`
- [Print Macros](https://github.com/treed-hub/printer-core/blob/treed-v2/klipper/profiles/treed_v2_corexy_v1/macros_print_flow.cfg): `klipper/profiles/treed_v2_corexy_v1/macros_print_flow.cfg`
- [Klipper Extensions](https://github.com/treed-hub/printer-core/tree/treed-v2/klipper-host): `klipper-host`
- [Driver Modes](https://github.com/treed-hub/printer-core/blob/treed-v2/klipper-host/treed_driver_mode.py): `klipper-host/treed_driver_mode.py`
- [SGT Calibration](https://github.com/treed-hub/printer-core/blob/treed-v2/klipper-host/treed_sgt_executor.py): `klipper-host/treed_sgt_executor.py`
- [Z Recovery](https://github.com/treed-hub/printer-core/blob/treed-v2/klipper-host/treed_z_recovery.py): `klipper-host/treed_z_recovery.py`

### Host Services

- [Moonraker Config](https://github.com/treed-hub/printer-core/tree/treed-v2/moonraker): `moonraker`
- [Core and UI Update](https://github.com/treed-hub/printer-core/blob/treed-v2/moonraker/components/treed_update.py): `moonraker/components/treed_update.py`
- [Host Recovery](https://github.com/treed-hub/printer-core/blob/treed-v2/moonraker/components/treed_recovery.py): `moonraker/components/treed_recovery.py`
- [Wi-Fi Management](https://github.com/treed-hub/printer-core/blob/treed-v2/moonraker/components/treed_host_network.py): `moonraker/components/treed_host_network.py`
- [Filament Settings](https://github.com/treed-hub/printer-core/blob/treed-v2/moonraker/components/treed_filament_sensor.py): `moonraker/components/treed_filament_sensor.py`
- [Printer Detection](https://github.com/treed-hub/printer-core/blob/treed-v2/moonraker/components/treed_detection.py): `moonraker/components/treed_detection.py`
- [Camera Diagnostics](https://github.com/treed-hub/printer-core/blob/treed-v2/runtime-scripts/treed-cam/stream_detect.py): `runtime-scripts/treed-cam/stream_detect.py`

### Operator Interfaces

- [TreeD Shell](https://github.com/treed-hub/printer-core/blob/treed-v2/runtime-scripts/treed-ui/treed-ui): `runtime-scripts/treed-ui/treed-ui`
- [Mainsail UI](https://github.com/treed-hub/printer-core/tree/treed-v2/mainsail): `mainsail`
- [KlipperScreen Theme](https://github.com/treed-hub/printer-core/tree/treed-v2/klipperscreen/themes/treed-oled): `klipperscreen/themes/treed-oled`
- [Printer Events](https://github.com/treed-hub/printer-core/blob/treed-v2/contracts/printer-events.md): `contracts/printer-events.md`

### Hardware Targets

- [Firmware Targets](https://github.com/treed-hub/printer-core/tree/treed-v2/firmware/configs/treed_v2): `firmware/configs/treed_v2`
- **V2 Hardware**

### Other components

- **Operator**

## Connections

- Operator → Bootstrap: installs (evidence: `README.md`)
- Bootstrap → Loader: starts (evidence: `README.md`)
- Loader → Provision Steps: runs steps (evidence: `README.md`)
- Loader → Runtime Config: stages configs (evidence: `README.md`)
- Loader → Firmware Targets: builds targets (evidence: `README.md`)
- Runtime Config → Print Macros: defines print flow (evidence: `README.md`)
- Print Macros → V2 Hardware: controls printing (evidence: `README.md`)
- Klipper Extensions → V2 Hardware: extends control (evidence: `README.md`)
- Driver Modes → Klipper Extensions: provides mode control (evidence: `README.md`)
- SGT Calibration → Klipper Extensions: provides calibration (evidence: `README.md`)
- Z Recovery → Klipper Extensions: provides Z recovery (evidence: `README.md`)
- Firmware Targets → V2 Hardware: targets (evidence: `README.md`)
- Operator → TreeD Shell: manages (evidence: `README.md`)
- TreeD Shell → Core and UI Update: requests updates (evidence: `README.md`)
- TreeD Shell → Wi-Fi Management: manages Wi-Fi (evidence: `README.md`)
- TreeD Shell → Filament Settings: sets sensitivity (evidence: `README.md`)
- TreeD Shell → Host Recovery: requests recovery
- Moonraker Config → Core and UI Update: configures
- Moonraker Config → Wi-Fi Management: configures
- Moonraker Config → Host Recovery: configures
- Moonraker Config → Filament Settings: configures
- Mainsail UI → V2 Hardware: operates printer
- KlipperScreen Theme → V2 Hardware: displays status
- V2 Hardware → Printer Events: publishes events (evidence: `README.md`)
- Printer Events → TreeD Shell: drives notifications (evidence: `README.md`)
- Printer Events → Mainsail UI: exposes stream (evidence: `README.md`)
- Operator → Camera Diagnostics: runs diagnostics (evidence: `README.md`)
- Printer Detection → V2 Hardware: reports status
