# martinwoodward/octolamp architecture

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

- Interactive diagram: https://gitdiagram.com/martinwoodward/octolamp
- Repository: https://github.com/martinwoodward/octolamp

## Overview

Octolamp is a 3D-printable smart-light project: its repository supplies printable model files, while the README describes building the lamp around an LED strip and a WLED-compatible controller. The documented user workflow is to print and assemble the parts, install and configure WLED, wire the LEDs, set the strip length, and control the display through WLED or Home Assistant. Model filenames indicate additional multipart, mini, and motion-oriented variants. No source excerpts were provided, so relationships below rely on README statements; variant relationships are not inferred.

Main entry points: [`models/octolamp_white_inner.stl`](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_inner.stl) (White inner), [`models/octolamp_black_outer.stl`](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_black_outer.stl) (Black base), [`models/octolamp_white_reflector.stl`](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_reflector.stl) (White reflector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_printed_parts["Printed lamp parts"]
  node_black_base_stl["Black base"]
  node_white_inner_stl["White inner"]
  node_white_reflector_stl["White reflector"]
end

subgraph group_model_variants["Model variants"]
  node_black_outer_3mf["Black outer 3MF"]
  node_black_outer_mini_stl["Mini motion outer"]
  node_mini_top_stl["Mini motion top"]
  node_multipart_3mf["Multipart model"]
  node_multipart_a1_3mf["A1 Mini multipart"]
  node_mini_multipart_3mf["Mini motion multipart"]
  node_white_inner_3mf["White inner 3MF"]
  node_white_reflector_3mf["Reflector 3MF"]
  node_design_source["Fusion design<br/>[octolamp.f3d]"]
  node_reflector_laser["Laser reflector"]
  node_black_outer_stl["Black outer STL"]
  node_white_inner_stl_alt["White inner STL"]
  node_white_reflector_stl_alt["White reflector STL"]
end

subgraph group_light_hardware["Light hardware"]
  node_led_strip["WS2812B LED strip"]
  node_controller["WLED controller"]
  node_assembled_lamp["Assembled lamp"]
end

subgraph group_control_integrations["Control integrations"]
  node_wled["WLED"]
  node_wifi["WiFi network"]
  node_home_assistant["Home Assistant"]
  node_github["GitHub activity"]
end

node_builder(("Builder"))
node_printer["3D printer"]

node_builder -->|"prints"| node_black_base_stl
node_builder -->|"prints"| node_white_inner_stl
node_builder -->|"prints"| node_white_reflector_stl
node_black_base_stl -->|"printed on"| node_printer
node_white_inner_stl -->|"printed on"| node_printer
node_white_reflector_stl -->|"printed on"| node_printer
node_builder -->|"assembles"| node_assembled_lamp
node_black_base_stl -->|"snap-fits with"| node_assembled_lamp
node_white_inner_stl -->|"snap-fits with"| node_assembled_lamp
node_white_reflector_stl -->|"fits into"| node_assembled_lamp
node_builder -->|"attaches"| node_led_strip
node_led_strip -->|"sticks to"| node_white_inner_stl
node_builder -->|"wires"| node_controller
node_led_strip -->|"connects to"| node_controller
node_builder -->|"installs and configures"| node_wled
node_controller -->|"runs"| node_wled
node_wled -->|"connects through"| node_wifi
node_builder -->|"sets LED length"| node_wled
node_home_assistant -->|"controls"| node_wled
node_github -.->|"can trigger automation"| node_wled

click node_black_base_stl "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_black_outer.stl"
click node_white_inner_stl "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_inner.stl"
click node_white_reflector_stl "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_reflector.stl"
click node_black_outer_3mf "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_black_outer.3mf"
click node_black_outer_mini_stl "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_black_outer_mini_sparkle_motion.stl"
click node_mini_top_stl "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_black_outer_mini_sparkle_motion_top.stl"
click node_multipart_3mf "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_multipart.3mf"
click node_multipart_a1_3mf "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_multipart_A1_mini.3mf"
click node_mini_multipart_3mf "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_multipart_mini_sparkle_motion.3mf"
click node_white_inner_3mf "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_inner.3mf"
click node_white_reflector_3mf "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_reflector.3mf"
click node_design_source "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp.f3d"
click node_reflector_laser "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_reflector_laser.dxf"
click node_black_outer_stl "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_black_outer.stl"
click node_white_inner_stl_alt "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_inner.stl"
click node_white_reflector_stl_alt "https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_reflector.stl"

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_black_base_stl,node_white_inner_stl,node_white_reflector_stl toneBlue
class node_black_outer_3mf,node_black_outer_mini_stl,node_mini_top_stl,node_multipart_3mf,node_multipart_a1_3mf,node_mini_multipart_3mf,node_white_inner_3mf,node_white_reflector_3mf,node_design_source,node_reflector_laser,node_black_outer_stl,node_white_inner_stl_alt,node_white_reflector_stl_alt toneAmber
class node_led_strip,node_controller,node_assembled_lamp toneMint
class node_wled,node_wifi,node_home_assistant,node_github toneRose
class node_builder,node_printer toneIndigo
```

## Components

### Printed lamp parts

- [Black base](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_black_outer.stl): `models/octolamp_black_outer.stl`
- [White inner](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_inner.stl): `models/octolamp_white_inner.stl`
- [White reflector](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_reflector.stl): `models/octolamp_white_reflector.stl`

### Model variants

- [Black outer 3MF](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_black_outer.3mf): `models/octolamp_black_outer.3mf`
- [Mini motion outer](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_black_outer_mini_sparkle_motion.stl): `models/octolamp_black_outer_mini_sparkle_motion.stl`
- [Mini motion top](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_black_outer_mini_sparkle_motion_top.stl): `models/octolamp_black_outer_mini_sparkle_motion_top.stl`
- [Multipart model](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_multipart.3mf): `models/octolamp_multipart.3mf`
- [A1 Mini multipart](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_multipart_A1_mini.3mf): `models/octolamp_multipart_A1_mini.3mf`
- [Mini motion multipart](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_multipart_mini_sparkle_motion.3mf): `models/octolamp_multipart_mini_sparkle_motion.3mf`
- [White inner 3MF](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_inner.3mf): `models/octolamp_white_inner.3mf`
- [Reflector 3MF](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_reflector.3mf): `models/octolamp_white_reflector.3mf`
- [Fusion design](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp.f3d): `models/octolamp.f3d`
- [Laser reflector](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_reflector_laser.dxf): `models/octolamp_white_reflector_laser.dxf`
- [Black outer STL](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_black_outer.stl): `models/octolamp_black_outer.stl`
- [White inner STL](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_inner.stl): `models/octolamp_white_inner.stl`
- [White reflector STL](https://github.com/martinwoodward/octolamp/blob/main/models/octolamp_white_reflector.stl): `models/octolamp_white_reflector.stl`

### Light hardware

- **WS2812B LED strip**
- **WLED controller**
- **Assembled lamp**

### Control integrations

- **WLED**
- **WiFi network**
- **Home Assistant**
- **GitHub activity**

### Other components

- **Builder**
- **3D printer**

## Connections

- Builder → Black base: prints (evidence: `README.md`)
- Builder → White inner: prints (evidence: `README.md`)
- Builder → White reflector: prints (evidence: `README.md`)
- Black base → 3D printer: printed on (evidence: `README.md`)
- White inner → 3D printer: printed on (evidence: `README.md`)
- White reflector → 3D printer: printed on (evidence: `README.md`)
- Builder → Assembled lamp: assembles (evidence: `README.md`)
- Black base → Assembled lamp: snap-fits with (evidence: `README.md`)
- White inner → Assembled lamp: snap-fits with (evidence: `README.md`)
- White reflector → Assembled lamp: fits into (evidence: `README.md`)
- Builder → WS2812B LED strip: attaches (evidence: `README.md`)
- WS2812B LED strip → White inner: sticks to (evidence: `README.md`)
- Builder → WLED controller: wires (evidence: `README.md`)
- WS2812B LED strip → WLED controller: connects to (evidence: `README.md`)
- Builder → WLED: installs and configures (evidence: `README.md`)
- WLED controller → WLED: runs (evidence: `README.md`)
- WLED → WiFi network: connects through (evidence: `README.md`)
- Builder → WLED: sets LED length (evidence: `README.md`)
- Home Assistant → WLED: controls (evidence: `README.md`)
- GitHub activity → WLED: can trigger automation (evidence: `README.md`)
