# salman-cc/cam architecture

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

- Interactive diagram: https://gitdiagram.com/salman-cc/cam
- Repository: https://github.com/salman-cc/cam

## Overview

camstream turns camera frames into browser-viewable H.264 over WebRTC. In the native workflow, the server configures capture and encoding, negotiates a viewer over HTTP signaling, then sends media over ICE/DTLS-SRTP; diagnostics and mDNS support operation on the LAN. A separate libpeer server reuses the media pipeline with a distinct signaling and per-viewer session model. The repository also includes a standalone Mongoose static-file server. Edges use README statements or the shown source references; unsampled implementation details are not inferred.

Main entry points: [`src/lpstream/lp_server.c`](https://github.com/salman-cc/cam/blob/main/src/lpstream/lp_server.c) (Libpeer server), [`src/app/app_server.c`](https://github.com/salman-cc/cam/blob/main/src/app/app_server.c) (Native server loop), [`src/webrtc/webrtc_session.c`](https://github.com/salman-cc/cam/blob/main/src/webrtc/webrtc_session.c) (WebRTC sessions), [`src/media/encoder_worker.c`](https://github.com/salman-cc/cam/blob/main/src/media/encoder_worker.c) (Encoder worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and HTTP"]
  node_main["Native entry<br/>[camstream_main.c]"]
  node_config["Configuration<br/>[app_config.c]"]
  node_appserver["Native server loop<br/>[app_server.c]"]
  node_diagnostics["Diagnostics and logs<br/>[sysinfo.c]"]
end

subgraph group_media["Capture and encoding"]
  node_source["Video source drivers"]
  node_capture["Capture worker<br/>[source_worker.c]"]
  node_hub[("Frame hub and pool<br/>[frame_hub.c]")]
  node_encoderworker["Encoder worker<br/>[encoder_worker.c]"]
  node_encoder["H.264 encoder<br/>[h264_encoder.c]"]
  node_hwencoder["V4L2 encoder<br/>[encoder_v4l2m2m.c]"]
  node_swencoder["x264 encoder<br/>[encoder_x264.c]"]
  node_ring[("Access-unit ring<br/>[au_ring.c]")]
end

subgraph group_native["Native WebRTC"]
  node_native_session["WebRTC sessions<br/>[webrtc_session.c]"]
  node_sdp["SDP negotiation<br/>[sdp.c]"]
  node_ice["ICE-lite transport<br/>[ice_lite.c]"]
  node_dtls["DTLS-SRTP<br/>[dtls_srtp.c]"]
  node_rtp["RTP and RTCP<br/>[rtp_h264.c]"]
end

subgraph group_peer["Libpeer WebRTC"]
  node_lp_entry["Libpeer entry"]
  node_lpserver["Libpeer server<br/>[lp_server.c]"]
  node_lpsdp["SDP sanitizer<br/>[lp_sdp.c]"]
  node_lpsession["Libpeer sessions<br/>[lp_session.c]"]
end

subgraph group_services["LAN and standalone HTTP"]
  node_mdns["mDNS responder<br/>[mdns.c]"]
  node_mongoose["Mongoose HTTP<br/>[mongoose.c]"]
  node_standalone["Static-file server<br/>[server.c]"]
end

node_operator(("Operator"))
node_browser(("Browser viewer"))
node_camera(("Camera or input"))
node_lan(("LAN clients"))

node_operator -->|"starts"| node_main
node_main -->|"loads settings"| node_config
node_main -->|"starts server"| node_appserver
node_appserver -->|"configures capture"| node_source
node_camera -->|"provides frames"| node_source
node_source -->|"captures frames"| node_capture
node_capture -->|"publishes frames"| node_hub
node_hub -->|"supplies frames"| node_encoderworker
node_encoderworker -->|"encodes frames"| node_encoder
node_encoder -->|"selects backend"| node_hwencoder
node_encoder -->|"selects backend"| node_swencoder
node_encoderworker -->|"publishes access units"| node_ring
node_appserver -->|"manages viewers"| node_native_session
node_browser -->|"offers over HTTP"| node_appserver
node_native_session -->|"negotiates SDP"| node_sdp
node_native_session -->|"checks connectivity"| node_ice
node_native_session -->|"drives handshake"| node_dtls
node_native_session -->|"packetizes media"| node_rtp
node_ring -->|"supplies access units"| node_native_session
node_appserver -->|"serves status"| node_diagnostics
node_appserver -->|"polls responder"| node_mdns
node_mdns -->|"announces name"| node_lan
node_lp_entry -->|"starts server"| node_lpserver
node_lpserver -->|"configures capture"| node_source
node_lpserver -->|"creates frame hub"| node_hub
node_lpserver -->|"starts encoder worker"| node_encoderworker
node_lpserver -->|"creates access-unit ring"| node_ring
node_lpserver -->|"sanitizes answers"| node_lpsdp
node_lpserver -->|"creates sessions"| node_lpsession
node_ring -->|"feeds media fan-out"| node_lpserver
node_lpserver -->|"signals over HTTP"| node_browser
node_lpserver -->|"polls responder"| node_mdns
node_standalone -->|"uses HTTP library"| node_mongoose
node_lan -->|"requests static files"| node_standalone

click node_main "https://github.com/salman-cc/cam/blob/main/src/camstream_main.c"
click node_config "https://github.com/salman-cc/cam/blob/main/src/app/app_config.c"
click node_appserver "https://github.com/salman-cc/cam/blob/main/src/app/app_server.c"
click node_diagnostics "https://github.com/salman-cc/cam/blob/main/src/app/sysinfo.c"
click node_capture "https://github.com/salman-cc/cam/blob/main/src/media/source_worker.c"
click node_hub "https://github.com/salman-cc/cam/blob/main/src/media/frame_hub.c"
click node_encoderworker "https://github.com/salman-cc/cam/blob/main/src/media/encoder_worker.c"
click node_encoder "https://github.com/salman-cc/cam/blob/main/src/media/h264_encoder.c"
click node_hwencoder "https://github.com/salman-cc/cam/blob/main/src/media/encoder_v4l2m2m.c"
click node_swencoder "https://github.com/salman-cc/cam/blob/main/src/media/encoder_x264.c"
click node_ring "https://github.com/salman-cc/cam/blob/main/src/media/au_ring.c"
click node_native_session "https://github.com/salman-cc/cam/blob/main/src/webrtc/webrtc_session.c"
click node_sdp "https://github.com/salman-cc/cam/blob/main/src/webrtc/sdp.c"
click node_ice "https://github.com/salman-cc/cam/blob/main/src/webrtc/ice_lite.c"
click node_dtls "https://github.com/salman-cc/cam/blob/main/src/webrtc/dtls_srtp.c"
click node_rtp "https://github.com/salman-cc/cam/blob/main/src/webrtc/rtp_h264.c"
click node_lp_entry "https://github.com/salman-cc/cam/blob/main/src/lpstream/camstream_libpeer_main.c"
click node_lpserver "https://github.com/salman-cc/cam/blob/main/src/lpstream/lp_server.c"
click node_lpsdp "https://github.com/salman-cc/cam/blob/main/src/lpstream/lp_sdp.c"
click node_lpsession "https://github.com/salman-cc/cam/blob/main/src/lpstream/lp_session.c"
click node_mdns "https://github.com/salman-cc/cam/blob/main/src/net/mdns.c"
click node_mongoose "https://github.com/salman-cc/cam/blob/main/mongoose.c"
click node_standalone "https://github.com/salman-cc/cam/blob/main/server.c"

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_main,node_config,node_appserver,node_diagnostics,node_browser,node_lan toneBlue
class node_source,node_capture,node_hub,node_encoderworker,node_encoder,node_hwencoder,node_swencoder,node_ring toneAmber
class node_native_session,node_sdp,node_ice,node_dtls,node_rtp toneMint
class node_lp_entry,node_lpserver,node_lpsdp,node_lpsession toneRose
class node_mdns,node_mongoose,node_standalone,node_operator,node_camera toneIndigo
```

## Components

### Application and HTTP

- [Native entry](https://github.com/salman-cc/cam/blob/main/src/camstream_main.c): `src/camstream_main.c`
- [Configuration](https://github.com/salman-cc/cam/blob/main/src/app/app_config.c): `src/app/app_config.c`
- [Native server loop](https://github.com/salman-cc/cam/blob/main/src/app/app_server.c): `src/app/app_server.c`
- [Diagnostics and logs](https://github.com/salman-cc/cam/blob/main/src/app/sysinfo.c): `src/app/sysinfo.c`

### Capture and encoding

- **Video source drivers**
- [Capture worker](https://github.com/salman-cc/cam/blob/main/src/media/source_worker.c): `src/media/source_worker.c`
- [Frame hub and pool](https://github.com/salman-cc/cam/blob/main/src/media/frame_hub.c): `src/media/frame_hub.c`
- [Encoder worker](https://github.com/salman-cc/cam/blob/main/src/media/encoder_worker.c): `src/media/encoder_worker.c`
- [H.264 encoder](https://github.com/salman-cc/cam/blob/main/src/media/h264_encoder.c): `src/media/h264_encoder.c`
- [V4L2 encoder](https://github.com/salman-cc/cam/blob/main/src/media/encoder_v4l2m2m.c): `src/media/encoder_v4l2m2m.c`
- [x264 encoder](https://github.com/salman-cc/cam/blob/main/src/media/encoder_x264.c): `src/media/encoder_x264.c`
- [Access-unit ring](https://github.com/salman-cc/cam/blob/main/src/media/au_ring.c): `src/media/au_ring.c`

### Native WebRTC

- [WebRTC sessions](https://github.com/salman-cc/cam/blob/main/src/webrtc/webrtc_session.c): `src/webrtc/webrtc_session.c`
- [SDP negotiation](https://github.com/salman-cc/cam/blob/main/src/webrtc/sdp.c): `src/webrtc/sdp.c`
- [ICE-lite transport](https://github.com/salman-cc/cam/blob/main/src/webrtc/ice_lite.c): `src/webrtc/ice_lite.c`
- [DTLS-SRTP](https://github.com/salman-cc/cam/blob/main/src/webrtc/dtls_srtp.c): `src/webrtc/dtls_srtp.c`
- [RTP and RTCP](https://github.com/salman-cc/cam/blob/main/src/webrtc/rtp_h264.c): `src/webrtc/rtp_h264.c`

### Libpeer WebRTC

- [Libpeer entry](https://github.com/salman-cc/cam/blob/main/src/lpstream/camstream_libpeer_main.c): `src/lpstream/camstream_libpeer_main.c`
- [Libpeer server](https://github.com/salman-cc/cam/blob/main/src/lpstream/lp_server.c): `src/lpstream/lp_server.c`
- [SDP sanitizer](https://github.com/salman-cc/cam/blob/main/src/lpstream/lp_sdp.c): `src/lpstream/lp_sdp.c`
- [Libpeer sessions](https://github.com/salman-cc/cam/blob/main/src/lpstream/lp_session.c): `src/lpstream/lp_session.c`

### LAN and standalone HTTP

- [mDNS responder](https://github.com/salman-cc/cam/blob/main/src/net/mdns.c): `src/net/mdns.c`
- [Mongoose HTTP](https://github.com/salman-cc/cam/blob/main/mongoose.c): `mongoose.c`
- [Static-file server](https://github.com/salman-cc/cam/blob/main/server.c): `server.c`

### Other components

- **Operator**
- **Browser viewer**
- **Camera or input**
- **LAN clients**

## Connections

- Operator → Native entry: starts
- Native entry → Configuration: loads settings (evidence: `src/camstream_main.c`)
- Native entry → Native server loop: starts server (evidence: `src/camstream_main.c`)
- Native server loop → Video source drivers: configures capture (evidence: `src/app/app_server.c`)
- Camera or input → Video source drivers: provides frames
- Video source drivers → Capture worker: captures frames
- Capture worker → Frame hub and pool: publishes frames
- Frame hub and pool → Encoder worker: supplies frames
- Encoder worker → H.264 encoder: encodes frames
- H.264 encoder → V4L2 encoder: selects backend
- H.264 encoder → x264 encoder: selects backend
- Encoder worker → Access-unit ring: publishes access units
- Native server loop → WebRTC sessions: manages viewers (evidence: `src/app/app_server.c`)
- Browser viewer → Native server loop: offers over HTTP
- WebRTC sessions → SDP negotiation: negotiates SDP
- WebRTC sessions → ICE-lite transport: checks connectivity (evidence: `src/webrtc/webrtc_session.c`)
- WebRTC sessions → DTLS-SRTP: drives handshake
- WebRTC sessions → RTP and RTCP: packetizes media (evidence: `src/webrtc/webrtc_session.c`)
- Access-unit ring → WebRTC sessions: supplies access units
- Native server loop → Diagnostics and logs: serves status (evidence: `src/app/app_server.c`)
- Native server loop → mDNS responder: polls responder (evidence: `src/app/app_server.c`)
- mDNS responder → LAN clients: announces name
- Libpeer entry → Libpeer server: starts server
- Libpeer server → Video source drivers: configures capture (evidence: `src/lpstream/lp_server.c`)
- Libpeer server → Frame hub and pool: creates frame hub (evidence: `src/lpstream/lp_server.c`)
- Libpeer server → Encoder worker: starts encoder worker (evidence: `src/lpstream/lp_server.c`)
- Libpeer server → Access-unit ring: creates access-unit ring (evidence: `src/lpstream/lp_server.c`)
- Libpeer server → SDP sanitizer: sanitizes answers (evidence: `src/lpstream/lp_server.c`)
- Libpeer server → Libpeer sessions: creates sessions (evidence: `src/lpstream/lp_server.c`)
- Access-unit ring → Libpeer server: feeds media fan-out
- Libpeer server → Browser viewer: signals over HTTP
- Libpeer server → mDNS responder: polls responder (evidence: `src/lpstream/lp_server.c`)
- Static-file server → Mongoose HTTP: uses HTTP library (evidence: `server.c`)
- LAN clients → Static-file server: requests static files
