# versatica/mediasoup architecture

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

- Interactive diagram: https://gitdiagram.com/versatica/mediasoup
- Repository: https://github.com/versatica/mediasoup

## Overview

mediasoup is a low-level Selective Forwarding Unit (SFU), exposed as Node.js and Rust server APIs with a C++ media worker. The principal workflow is for an application to create a worker and router, establish transports, publish media or data, then create consumers to forward selected streams to endpoints. The README also documents plain RTP, simulcast/SVC, congestion control, and audio-level/active-speaker capabilities. Paths and domain responsibilities are grounded in the tree; unsampled subsystem wiring is shown only where documented, so some internal call links are omitted.

Main entry points: [`node/src/Transport.ts`](https://github.com/versatica/mediasoup/blob/v3/node/src/Transport.ts) (Transports), [`node/src/Router.ts`](https://github.com/versatica/mediasoup/blob/v3/node/src/Router.ts) (Router), [`node/src/Worker.ts`](https://github.com/versatica/mediasoup/blob/v3/node/src/Worker.ts) (Node Worker), [`worker/src/main.cpp`](https://github.com/versatica/mediasoup/blob/v3/worker/src/main.cpp) (Worker Runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Server APIs"]
  node_node_api["Node API<br/>[index.ts]"]
  node_rust_api["Rust API<br/>[lib.rs]"]
  node_worker_manager["Worker Manager<br/>[worker_manager.rs]"]
  node_node_worker["Node Worker<br/>[Worker.ts]"]
end

subgraph group_routing["Routing and Media"]
  node_router["Router<br/>[Router.ts]"]
  node_transport["Transports<br/>[Transport.ts]"]
  node_webrtc_transport["WebRTC Transport<br/>[WebRtcTransport.ts]"]
  node_plain_transport["Plain RTP<br/>[PlainTransport.ts]"]
  node_producer["Producer<br/>[Producer.ts]"]
  node_consumer["Consumer<br/>[Consumer.ts]"]
  node_data_producer["Data Producer<br/>[DataProducer.ts]"]
  node_data_consumer["Data Consumer<br/>[DataConsumer.ts]"]
  node_observers["RTP Observers<br/>[RtpObserver.ts]"]
  node_ortc["RTP Capabilities<br/>[ortc.ts]"]
end

subgraph group_worker["Media Worker"]
  node_worker_runtime["Worker Runtime<br/>[main.cpp]"]
  node_port_manager["Port Manager<br/>[PortManager.cpp]"]
  node_stream_manager["Stream Manager"]
end

subgraph group_network["Network and Adaptation"]
  node_network_controller["Send Controller"]
  node_loss_controller["Loss Estimator"]
  node_probe_controller["Probe Controller"]
end

node_application(("Application"))
node_endpoint(("WebRTC / RTP Endpoint"))

node_application -->|"uses"| node_node_api
node_application -.->|"uses"| node_rust_api
node_node_api -->|"creates"| node_node_worker
node_rust_api -->|"creates workers"| node_worker_manager
node_node_worker -->|"starts worker"| node_worker_runtime
node_node_worker -->|"creates router"| node_router
node_router -->|"creates transports"| node_transport
node_transport -->|"specializes"| node_webrtc_transport
node_transport -->|"specializes"| node_plain_transport
node_router -->|"uses capabilities"| node_ortc
node_transport -->|"publishes media"| node_producer
node_transport -->|"forwards media"| node_consumer
node_transport -->|"publishes data"| node_data_producer
node_transport -->|"forwards data"| node_data_consumer
node_router -->|"creates observers"| node_observers
node_worker_runtime -->|"binds ports"| node_port_manager
node_worker_runtime -->|"processes streams"| node_stream_manager
node_stream_manager -->|"adapts layers"| node_network_controller
node_network_controller -->|"estimates bitrate"| node_loss_controller
node_network_controller -->|"requests probes"| node_probe_controller
node_webrtc_transport -->|"exchanges media"| node_endpoint
node_plain_transport -->|"exchanges RTP"| node_endpoint
node_data_consumer -->|"sends data"| node_endpoint

click node_node_api "https://github.com/versatica/mediasoup/blob/v3/node/src/index.ts"
click node_rust_api "https://github.com/versatica/mediasoup/blob/v3/rust/src/lib.rs"
click node_worker_manager "https://github.com/versatica/mediasoup/blob/v3/rust/src/worker_manager.rs"
click node_node_worker "https://github.com/versatica/mediasoup/blob/v3/node/src/Worker.ts"
click node_router "https://github.com/versatica/mediasoup/blob/v3/node/src/Router.ts"
click node_transport "https://github.com/versatica/mediasoup/blob/v3/node/src/Transport.ts"
click node_webrtc_transport "https://github.com/versatica/mediasoup/blob/v3/node/src/WebRtcTransport.ts"
click node_plain_transport "https://github.com/versatica/mediasoup/blob/v3/node/src/PlainTransport.ts"
click node_producer "https://github.com/versatica/mediasoup/blob/v3/node/src/Producer.ts"
click node_consumer "https://github.com/versatica/mediasoup/blob/v3/node/src/Consumer.ts"
click node_data_producer "https://github.com/versatica/mediasoup/blob/v3/node/src/DataProducer.ts"
click node_data_consumer "https://github.com/versatica/mediasoup/blob/v3/node/src/DataConsumer.ts"
click node_observers "https://github.com/versatica/mediasoup/blob/v3/node/src/RtpObserver.ts"
click node_ortc "https://github.com/versatica/mediasoup/blob/v3/node/src/ortc.ts"
click node_worker_runtime "https://github.com/versatica/mediasoup/blob/v3/worker/src/main.cpp"
click node_port_manager "https://github.com/versatica/mediasoup/blob/v3/worker/src/RTC/PortManager.cpp"
click node_stream_manager "https://github.com/versatica/mediasoup/blob/v3/worker/src/RTC/SimulcastProducerStreamManager.cpp"
click node_network_controller "https://github.com/versatica/mediasoup/blob/v3/worker/deps/libwebrtc/libwebrtc/call/rtp_transport_controller_send.cc"
click node_loss_controller "https://github.com/versatica/mediasoup/blob/v3/worker/src/RTC/BWE/LossBasedController.cpp"
click node_probe_controller "https://github.com/versatica/mediasoup/blob/v3/worker/src/RTC/BWE/ProbeController.cpp"

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_node_api,node_rust_api,node_worker_manager,node_node_worker toneBlue
class node_router,node_transport,node_webrtc_transport,node_plain_transport,node_producer,node_consumer,node_data_producer,node_data_consumer,node_observers,node_ortc toneAmber
class node_worker_runtime,node_port_manager,node_stream_manager toneMint
class node_network_controller,node_loss_controller,node_probe_controller toneRose
class node_application,node_endpoint toneIndigo
```

## Components

### Server APIs

- [Node API](https://github.com/versatica/mediasoup/blob/v3/node/src/index.ts): `node/src/index.ts`
- [Rust API](https://github.com/versatica/mediasoup/blob/v3/rust/src/lib.rs): `rust/src/lib.rs`
- [Worker Manager](https://github.com/versatica/mediasoup/blob/v3/rust/src/worker_manager.rs): `rust/src/worker_manager.rs`
- [Node Worker](https://github.com/versatica/mediasoup/blob/v3/node/src/Worker.ts): `node/src/Worker.ts`

### Routing and Media

- [Router](https://github.com/versatica/mediasoup/blob/v3/node/src/Router.ts): `node/src/Router.ts`
- [Transports](https://github.com/versatica/mediasoup/blob/v3/node/src/Transport.ts): `node/src/Transport.ts`
- [WebRTC Transport](https://github.com/versatica/mediasoup/blob/v3/node/src/WebRtcTransport.ts): `node/src/WebRtcTransport.ts`
- [Plain RTP](https://github.com/versatica/mediasoup/blob/v3/node/src/PlainTransport.ts): `node/src/PlainTransport.ts`
- [Producer](https://github.com/versatica/mediasoup/blob/v3/node/src/Producer.ts): `node/src/Producer.ts`
- [Consumer](https://github.com/versatica/mediasoup/blob/v3/node/src/Consumer.ts): `node/src/Consumer.ts`
- [Data Producer](https://github.com/versatica/mediasoup/blob/v3/node/src/DataProducer.ts): `node/src/DataProducer.ts`
- [Data Consumer](https://github.com/versatica/mediasoup/blob/v3/node/src/DataConsumer.ts): `node/src/DataConsumer.ts`
- [RTP Observers](https://github.com/versatica/mediasoup/blob/v3/node/src/RtpObserver.ts): `node/src/RtpObserver.ts`
- [RTP Capabilities](https://github.com/versatica/mediasoup/blob/v3/node/src/ortc.ts): `node/src/ortc.ts`

### Media Worker

- [Worker Runtime](https://github.com/versatica/mediasoup/blob/v3/worker/src/main.cpp): `worker/src/main.cpp`
- [Port Manager](https://github.com/versatica/mediasoup/blob/v3/worker/src/RTC/PortManager.cpp): `worker/src/RTC/PortManager.cpp`
- [Stream Manager](https://github.com/versatica/mediasoup/blob/v3/worker/src/RTC/SimulcastProducerStreamManager.cpp): `worker/src/RTC/SimulcastProducerStreamManager.cpp`

### Network and Adaptation

- [Send Controller](https://github.com/versatica/mediasoup/blob/v3/worker/deps/libwebrtc/libwebrtc/call/rtp_transport_controller_send.cc): `worker/deps/libwebrtc/libwebrtc/call/rtp_transport_controller_send.cc`
- [Loss Estimator](https://github.com/versatica/mediasoup/blob/v3/worker/src/RTC/BWE/LossBasedController.cpp): `worker/src/RTC/BWE/LossBasedController.cpp`
- [Probe Controller](https://github.com/versatica/mediasoup/blob/v3/worker/src/RTC/BWE/ProbeController.cpp): `worker/src/RTC/BWE/ProbeController.cpp`

### Other components

- **Application**
- **WebRTC / RTP Endpoint**

## Connections

- Application → Node API: uses
- Application → Rust API: uses
- Node API → Node Worker: creates
- Rust API → Worker Manager: creates workers
- Node Worker → Worker Runtime: starts worker
- Node Worker → Router: creates router
- Router → Transports: creates transports
- Transports → WebRTC Transport: specializes
- Transports → Plain RTP: specializes
- Router → RTP Capabilities: uses capabilities
- Transports → Producer: publishes media
- Transports → Consumer: forwards media
- Transports → Data Producer: publishes data
- Transports → Data Consumer: forwards data
- Router → RTP Observers: creates observers
- Worker Runtime → Port Manager: binds ports
- Worker Runtime → Stream Manager: processes streams
- Stream Manager → Send Controller: adapts layers
- Send Controller → Loss Estimator: estimates bitrate
- Send Controller → Probe Controller: requests probes
- WebRTC Transport → WebRTC / RTP Endpoint: exchanges media
- Plain RTP → WebRTC / RTP Endpoint: exchanges RTP
- Data Consumer → WebRTC / RTP Endpoint: sends data
