# amrhalim/socket-video-streaming architecture

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

- Interactive diagram: https://gitdiagram.com/amrhalim/socket-video-streaming
- Repository: https://github.com/amrhalim/socket-video-streaming

## Overview

This is a browser-based WebRTC broadcasting and viewing application with an HTTPS Socket.IO signaling server. A user starts a broadcast or requests to watch; the server tracks the active owner and routes WebRTC offers and answers, while peers exchange ICE candidates to establish media connections. The browser client also handles stream capture, playback, and user feedback. The excerpts show signaling and server state, but not the HTML markup; the repository’s certificate paths also appear inconsistent with the ssl_files directory, so certificate-file wiring is not modeled.

Main entry points: [`server.js`](https://github.com/amrhalim/socket-video-streaming/blob/master/server.js) (Socket signaling), [`public/client.js`](https://github.com/amrhalim/socket-video-streaming/blob/master/public/client.js) (Broadcast client), [`public/index.html`](https://github.com/amrhalim/socket-video-streaming/blob/master/public/index.html) (Streaming UI), [`config.js`](https://github.com/amrhalim/socket-video-streaming/blob/master/config.js) (Runtime config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser streaming"]
  node_ui["Streaming UI<br/>[index.html]"]
  node_broadcast["Broadcast client<br/>[client.js]"]
  node_watch["Watch client<br/>[client.js]"]
  node_peer_media["Peer media<br/>[client.js]"]
end

subgraph group_server["Signaling service"]
  node_signal["Socket signaling<br/>[server.js]"]
  node_session_state["Session state<br/>[server.js]"]
  node_static_files["Static file serving<br/>[server.js]"]
  node_runtime_config["Runtime config<br/>[config.js]"]
end

node_user(("Browser user"))
node_ice_services["STUN / TURN"]

node_user -->|"uses"| node_ui
node_ui -.->|"loads client"| node_broadcast
node_user -->|"starts broadcast"| node_broadcast
node_user -->|"requests stream"| node_watch
node_broadcast -->|"announces stream"| node_signal
node_watch -->|"requests session"| node_signal
node_signal -->|"tracks owner"| node_session_state
node_watch -->|"sends offer"| node_signal
node_signal -->|"routes offer"| node_broadcast
node_broadcast -->|"sends answer"| node_signal
node_signal -->|"routes answer"| node_watch
node_broadcast -->|"sends candidates"| node_signal
node_signal -->|"broadcasts candidates"| node_peer_media
node_watch -->|"negotiates media"| node_peer_media
node_broadcast -->|"provides stream"| node_peer_media
node_peer_media -->|"uses ICE servers"| node_ice_services
node_signal -->|"serves public files"| node_static_files
node_signal -->|"loads settings"| node_runtime_config

click node_ui "https://github.com/amrhalim/socket-video-streaming/blob/master/public/index.html"
click node_broadcast "https://github.com/amrhalim/socket-video-streaming/blob/master/public/client.js"
click node_watch "https://github.com/amrhalim/socket-video-streaming/blob/master/public/client.js"
click node_peer_media "https://github.com/amrhalim/socket-video-streaming/blob/master/public/client.js"
click node_signal "https://github.com/amrhalim/socket-video-streaming/blob/master/server.js"
click node_session_state "https://github.com/amrhalim/socket-video-streaming/blob/master/server.js"
click node_static_files "https://github.com/amrhalim/socket-video-streaming/blob/master/server.js"
click node_runtime_config "https://github.com/amrhalim/socket-video-streaming/blob/master/config.js"

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_ui,node_broadcast,node_watch,node_peer_media,node_user toneBlue
class node_signal,node_session_state,node_static_files,node_runtime_config toneAmber
class node_ice_services toneIndigo
```

## Components

### Browser streaming

- [Streaming UI](https://github.com/amrhalim/socket-video-streaming/blob/master/public/index.html): `public/index.html`
- [Broadcast client](https://github.com/amrhalim/socket-video-streaming/blob/master/public/client.js): `public/client.js`
- [Watch client](https://github.com/amrhalim/socket-video-streaming/blob/master/public/client.js): `public/client.js`
- [Peer media](https://github.com/amrhalim/socket-video-streaming/blob/master/public/client.js): `public/client.js`

### Signaling service

- [Socket signaling](https://github.com/amrhalim/socket-video-streaming/blob/master/server.js): `server.js`
- [Session state](https://github.com/amrhalim/socket-video-streaming/blob/master/server.js): `server.js`
- [Static file serving](https://github.com/amrhalim/socket-video-streaming/blob/master/server.js): `server.js`
- [Runtime config](https://github.com/amrhalim/socket-video-streaming/blob/master/config.js): `config.js`

### Other components

- **Browser user**
- **STUN / TURN**

## Connections

- Browser user → Streaming UI: uses
- Streaming UI → Broadcast client: loads client
- Browser user → Broadcast client: starts broadcast (evidence: `public/client.js`)
- Browser user → Watch client: requests stream (evidence: `public/client.js`)
- Broadcast client → Socket signaling: announces stream (evidence: `public/client.js`)
- Watch client → Socket signaling: requests session (evidence: `public/client.js`)
- Socket signaling → Session state: tracks owner (evidence: `server.js`)
- Watch client → Socket signaling: sends offer (evidence: `public/client.js`)
- Socket signaling → Broadcast client: routes offer (evidence: `server.js`)
- Broadcast client → Socket signaling: sends answer (evidence: `public/client.js`)
- Socket signaling → Watch client: routes answer (evidence: `server.js`)
- Broadcast client → Socket signaling: sends candidates (evidence: `public/client.js`)
- Socket signaling → Peer media: broadcasts candidates (evidence: `server.js`)
- Watch client → Peer media: negotiates media (evidence: `public/client.js`)
- Broadcast client → Peer media: provides stream (evidence: `public/client.js`)
- Peer media → STUN / TURN: uses ICE servers (evidence: `public/client.js`)
- Socket signaling → Static file serving: serves public files (evidence: `server.js`)
- Socket signaling → Runtime config: loads settings (evidence: `server.js`)
