# remis-astr/multicam architecture

> Architecture diagram of the GitHub repository remis-astr/multicam, 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/remis-astr/multicam
- Repository: https://github.com/remis-astr/multicam

## Overview

Multicam is a Raspberry Pi astronomy/all-sky camera served through a browser UI. The main workflow is browser control and preview, camera capture, then photo/timelapse delivery or browser-side RAW stacking; an external guider can request packed frames. The graph preserves documented sensor and networking options as well as Lucky Stack and deep-sky Live Stack. Relationships are limited to shown imports/calls or README statements; unsampled routes and UI wiring are not inferred beyond those documented capabilities.

Main entry points: [`opt/minicam/web/app.js`](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/app.js) (Web interface), [`opt/minicam/src/minicam/api/app.py`](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/app.py) (API application), [`opt/minicam/src/minicam/camera/controller.py`](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/camera/controller.py) (Camera controller), [`opt/minicam/src/minicam/camera/sensors.py`](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/camera/sensors.py) (Sensor profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_app["API application<br/>[app.py]"]
  node_control["Camera control<br/>[routes_control.py]"]
  node_preview["Live preview<br/>[routes_preview.py]"]
  node_capture["Photo capture<br/>[routes_capture.py]"]
  node_photos["Photo gallery<br/>[routes_photos.py]"]
  node_timelapse["Timelapse"]
  node_raw["RAW stream"]
  node_zstd["Zstd encoding<br/>[zstd.py]"]
  node_guide["Guider frames<br/>[routes_guide.py]"]
  node_wifi["WiFi controls<br/>[routes_wifi.py]"]
end

subgraph group_camera["Camera and sensors"]
  node_camera_core["Camera controller<br/>[controller.py]"]
  node_profiles["Sensor profiles<br/>[sensors.py]"]
  node_config[("Configuration state<br/>[config.py]")]
  node_imx290["IMX290 driver<br/>[imx290.c]"]
  node_imx477["IMX477 driver<br/>[imx477.c]"]
  node_other_drivers["Other sensor drivers"]
end

subgraph group_web["Browser imaging"]
  node_ui["Web interface<br/>[app.js]"]
  node_frame_receiver["Frame receiver"]
  node_dso["Live Stack<br/>[dso_stacker.js]"]
  node_dso_handler["Stack worker handler"]
  node_star_align["Star alignment<br/>[star_align.js]"]
  node_webgpu_stack["WebGPU stacking<br/>[webgpu_stacking.js]"]
  node_webgpu_worker["WebGPU stack worker"]
  node_cpu_worker["CPU stack worker"]
  node_shaders["GPU shaders<br/>[shaders.js]"]
  node_fzstd["Browser zstd decode<br/>[fzstd.js]"]
  node_ser_source["SER file source<br/>[ser_file_source.js]"]
  node_dng_source["DNG file source<br/>[dng_file_source.js]"]
end

subgraph group_platform["Device services"]
  node_usb["USB gadget network<br/>[usb_gadget.py]"]
end

node_operator(("Observer"))
node_external_guider(("External guider"))
node_phone_pc(("Phone or PC"))

node_operator -->|"uses"| node_ui
node_ui -.->|"sets controls"| node_control
node_ui -.->|"views preview"| node_preview
node_ui -.->|"requests photos"| node_capture
node_ui -.->|"browses gallery"| node_photos
node_ui -.->|"runs timelapse"| node_timelapse
node_ui -.->|"requests RAW"| node_raw
node_app -->|"registers route"| node_control
node_app -->|"registers route"| node_preview
node_app -->|"registers route"| node_capture
node_app -->|"registers route"| node_photos
node_app -->|"registers route"| node_guide
node_app -->|"registers route"| node_raw
node_app -->|"registers route"| node_timelapse
node_app -->|"registers route"| node_wifi
node_app -->|"creates camera"| node_camera_core
node_camera_core -->|"loads settings"| node_config
node_camera_core -->|"selects profile"| node_profiles
node_control -->|"updates sensor setting"| node_config
node_preview -->|"captures frames"| node_camera_core
node_capture -.->|"captures images"| node_camera_core
node_timelapse -->|"captures sequence"| node_camera_core
node_raw -.->|"captures RAW"| node_camera_core
node_raw -->|"encodes frames"| node_zstd
node_external_guider -->|"requests frame"| node_guide
node_guide -->|"captures RAW"| node_camera_core
node_phone_pc -->|"opens interface"| node_ui
node_frame_receiver -->|"decodes compressed data"| node_fzstd
node_frame_receiver -.->|"supplies frames"| node_dso_handler
node_dso_handler -->|"delegates stacking"| node_dso
node_dso -->|"aligns stars"| node_star_align
node_webgpu_worker -->|"dispatches messages"| node_dso_handler
node_cpu_worker -->|"dispatches messages"| node_dso_handler
node_webgpu_worker -->|"uses backend"| node_webgpu_stack
node_webgpu_stack -->|"uses shaders"| node_shaders
node_ser_source -.->|"provides local frames"| node_ui
node_dng_source -.->|"provides local frames"| node_ui
node_profiles -.->|"supports sensor"| node_imx290
node_profiles -.->|"supports sensor"| node_imx477
node_profiles -.->|"supports sensors"| node_other_drivers
node_usb -.->|"provides network link"| node_phone_pc
node_wifi -.->|"provides hotspot"| node_phone_pc

click node_ui "https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/app.js"
click node_app "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/app.py"
click node_control "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_control.py"
click node_preview "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_preview.py"
click node_capture "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_capture.py"
click node_photos "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_photos.py"
click node_timelapse "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_timelapse.py"
click node_raw "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_raw_stream.py"
click node_zstd "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/zstd.py"
click node_guide "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_guide.py"
click node_wifi "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_wifi.py"
click node_camera_core "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/camera/controller.py"
click node_profiles "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/camera/sensors.py"
click node_config "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/config.py"
click node_imx290 "https://github.com/remis-astr/multicam/blob/master/usr/src/imx290-crop/imx290.c"
click node_imx477 "https://github.com/remis-astr/multicam/blob/master/usr/src/imx477-planetary/imx477.c"
click node_frame_receiver "https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/ws_frame_receiver.js"
click node_dso "https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/dso_stacker.js"
click node_dso_handler "https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/dso_worker_handler.js"
click node_star_align "https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/star_align.js"
click node_webgpu_stack "https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/webgpu_stacking.js"
click node_webgpu_worker "https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/webgpu_stacking_worker.js"
click node_cpu_worker "https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/cpu_stacking_worker.js"
click node_shaders "https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/gpu/shaders.js"
click node_fzstd "https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/fzstd.js"
click node_ser_source "https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/ser_file_source.js"
click node_dng_source "https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/dng_file_source.js"
click node_usb "https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/net/usb_gadget.py"

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_app,node_control,node_preview,node_capture,node_photos,node_timelapse,node_raw,node_zstd,node_guide,node_wifi toneBlue
class node_camera_core,node_profiles,node_config,node_imx290,node_imx477,node_other_drivers toneAmber
class node_ui,node_frame_receiver,node_dso,node_dso_handler,node_star_align,node_webgpu_stack,node_webgpu_worker,node_cpu_worker,node_shaders,node_fzstd,node_ser_source,node_dng_source,node_operator toneMint
class node_usb toneRose
class node_external_guider,node_phone_pc toneIndigo
```

## Components

### HTTP API

- [API application](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/app.py): `opt/minicam/src/minicam/api/app.py`
- [Camera control](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_control.py): `opt/minicam/src/minicam/api/routes_control.py`
- [Live preview](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_preview.py): `opt/minicam/src/minicam/api/routes_preview.py`
- [Photo capture](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_capture.py): `opt/minicam/src/minicam/api/routes_capture.py`
- [Photo gallery](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_photos.py): `opt/minicam/src/minicam/api/routes_photos.py`
- [Timelapse](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_timelapse.py): `opt/minicam/src/minicam/api/routes_timelapse.py`
- [RAW stream](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_raw_stream.py): `opt/minicam/src/minicam/api/routes_raw_stream.py`
- [Zstd encoding](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/zstd.py): `opt/minicam/src/minicam/api/zstd.py`
- [Guider frames](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_guide.py): `opt/minicam/src/minicam/api/routes_guide.py`
- [WiFi controls](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/api/routes_wifi.py): `opt/minicam/src/minicam/api/routes_wifi.py`

### Camera and sensors

- [Camera controller](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/camera/controller.py): `opt/minicam/src/minicam/camera/controller.py`
- [Sensor profiles](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/camera/sensors.py): `opt/minicam/src/minicam/camera/sensors.py`
- [Configuration state](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/config.py): `opt/minicam/src/minicam/config.py`
- [IMX290 driver](https://github.com/remis-astr/multicam/blob/master/usr/src/imx290-crop/imx290.c): `usr/src/imx290-crop/imx290.c`
- [IMX477 driver](https://github.com/remis-astr/multicam/blob/master/usr/src/imx477-planetary/imx477.c): `usr/src/imx477-planetary/imx477.c`
- **Other sensor drivers**

### Browser imaging

- [Web interface](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/app.js): `opt/minicam/web/app.js`
- [Frame receiver](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/ws_frame_receiver.js): `opt/minicam/web/ws_frame_receiver.js`
- [Live Stack](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/dso_stacker.js): `opt/minicam/web/dso_stacker.js`
- [Stack worker handler](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/dso_worker_handler.js): `opt/minicam/web/dso_worker_handler.js`
- [Star alignment](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/star_align.js): `opt/minicam/web/star_align.js`
- [WebGPU stacking](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/webgpu_stacking.js): `opt/minicam/web/webgpu_stacking.js`
- [WebGPU stack worker](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/webgpu_stacking_worker.js): `opt/minicam/web/webgpu_stacking_worker.js`
- [CPU stack worker](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/cpu_stacking_worker.js): `opt/minicam/web/cpu_stacking_worker.js`
- [GPU shaders](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/gpu/shaders.js): `opt/minicam/web/gpu/shaders.js`
- [Browser zstd decode](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/fzstd.js): `opt/minicam/web/fzstd.js`
- [SER file source](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/ser_file_source.js): `opt/minicam/web/ser_file_source.js`
- [DNG file source](https://github.com/remis-astr/multicam/blob/master/opt/minicam/web/dng_file_source.js): `opt/minicam/web/dng_file_source.js`

### Device services

- [USB gadget network](https://github.com/remis-astr/multicam/blob/master/opt/minicam/src/minicam/net/usb_gadget.py): `opt/minicam/src/minicam/net/usb_gadget.py`

### Other components

- **Observer**
- **External guider**
- **Phone or PC**

## Connections

- Observer → Web interface: uses
- Web interface → Camera control: sets controls
- Web interface → Live preview: views preview
- Web interface → Photo capture: requests photos
- Web interface → Photo gallery: browses gallery
- Web interface → Timelapse: runs timelapse
- Web interface → RAW stream: requests RAW
- API application → Camera control: registers route (evidence: `opt/minicam/src/minicam/api/app.py`)
- API application → Live preview: registers route (evidence: `opt/minicam/src/minicam/api/app.py`)
- API application → Photo capture: registers route (evidence: `opt/minicam/src/minicam/api/app.py`)
- API application → Photo gallery: registers route (evidence: `opt/minicam/src/minicam/api/app.py`)
- API application → Guider frames: registers route (evidence: `opt/minicam/src/minicam/api/app.py`)
- API application → RAW stream: registers route (evidence: `opt/minicam/src/minicam/api/app.py`)
- API application → Timelapse: registers route (evidence: `opt/minicam/src/minicam/api/app.py`)
- API application → WiFi controls: registers route (evidence: `opt/minicam/src/minicam/api/app.py`)
- API application → Camera controller: creates camera (evidence: `opt/minicam/src/minicam/api/app.py`)
- Camera controller → Configuration state: loads settings (evidence: `opt/minicam/src/minicam/camera/controller.py`)
- Camera controller → Sensor profiles: selects profile (evidence: `opt/minicam/src/minicam/camera/controller.py`)
- Camera control → Configuration state: updates sensor setting (evidence: `opt/minicam/src/minicam/api/routes_control.py`)
- Live preview → Camera controller: captures frames (evidence: `opt/minicam/src/minicam/api/routes_preview.py`)
- Photo capture → Camera controller: captures images (evidence: `opt/minicam/src/minicam/api/routes_capture.py`)
- Timelapse → Camera controller: captures sequence (evidence: `opt/minicam/src/minicam/api/routes_timelapse.py`)
- RAW stream → Camera controller: captures RAW (evidence: `opt/minicam/src/minicam/api/routes_raw_stream.py`)
- RAW stream → Zstd encoding: encodes frames (evidence: `opt/minicam/src/minicam/api/routes_raw_stream.py`)
- External guider → Guider frames: requests frame (evidence: `opt/minicam/src/minicam/api/routes_guide.py`)
- Guider frames → Camera controller: captures RAW (evidence: `opt/minicam/src/minicam/api/routes_guide.py`)
- Phone or PC → Web interface: opens interface
- Frame receiver → Browser zstd decode: decodes compressed data (evidence: `opt/minicam/web/ws_frame_receiver.js`)
- Frame receiver → Stack worker handler: supplies frames
- Stack worker handler → Live Stack: delegates stacking (evidence: `opt/minicam/web/dso_worker_handler.js`)
- Live Stack → Star alignment: aligns stars (evidence: `opt/minicam/web/dso_stacker.js`)
- WebGPU stack worker → Stack worker handler: dispatches messages (evidence: `opt/minicam/web/webgpu_stacking_worker.js`)
- CPU stack worker → Stack worker handler: dispatches messages (evidence: `opt/minicam/web/cpu_stacking_worker.js`)
- WebGPU stack worker → WebGPU stacking: uses backend (evidence: `opt/minicam/web/webgpu_stacking_worker.js`)
- WebGPU stacking → GPU shaders: uses shaders (evidence: `opt/minicam/web/webgpu_stacking.js`)
- SER file source → Web interface: provides local frames
- DNG file source → Web interface: provides local frames
- Sensor profiles → IMX290 driver: supports sensor
- Sensor profiles → IMX477 driver: supports sensor
- Sensor profiles → Other sensor drivers: supports sensors
- USB gadget network → Phone or PC: provides network link
- WiFi controls → Phone or PC: provides hotspot
