# chenzhou0071/echoroom architecture

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

- Interactive diagram: https://gitdiagram.com/chenzhou0071/echoroom
- Repository: https://github.com/chenzhou0071/echoroom

## Overview

EchoRoom is a single-room desktop voice and video chat application for up to six participants. A user opens the client, authenticates or resumes a session, then chats and shares or watches media. TCP carries room control; UDP carries voice and video. The client handles audio processing and playback while the server relays media and manages room state and accounts. Major documented capabilities include device/settings management, profiles, chat, subscriptions, screen sharing, and camera video. Unsampled links are included only where the README documents them.

Main entry points: [`client/src-tauri/src/net/udp.rs`](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/net/udp.rs) (UDP media), [`server/src/tcp.rs`](https://github.com/chenzhou0071/echoroom/blob/dev/server/src/tcp.rs) (TCP service), [`client/src-tauri/src/bridge.rs`](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/bridge.rs) (UI bridge), [`client/src-tauri/src/net/tcp.rs`](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/net/tcp.rs) (TCP control)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Desktop client"]
  node_ui["Chat UI<br/>[app.js]"]
  node_bridge["UI bridge<br/>[bridge.rs]"]
  node_settings["Local settings<br/>[config.rs]"]
  node_tcp_client["TCP control<br/>[tcp.rs]"]
end

subgraph group_media["Client media"]
  node_capture["Audio capture<br/>[capture.rs]"]
  node_denoise["Noise reduction<br/>[denoise.rs]"]
  node_dsp["Audio DSP<br/>[dsp.rs]"]
  node_vad["Speech detection<br/>[vad.rs]"]
  node_opus["Opus codec<br/>[opus.rs]"]
  node_udp_client["UDP media<br/>[udp.rs]"]
  node_jitter["Jitter buffer<br/>[jitter.rs]"]
  node_mixer["Audio mixer<br/>[mixer.rs]"]
  node_playback["Audio playback<br/>[playback.rs]"]
  node_video_capture["Video capture<br/>[video_capture.js]"]
  node_video_view["Video viewer<br/>[video_view.js]"]
end

subgraph group_protocol["Shared protocol"]
  node_messages["Message types<br/>[messages.rs]"]
  node_tcp_codec["TCP codec<br/>[tcp.rs]"]
  node_udp_codec["UDP codec<br/>[udp.rs]"]
end

subgraph group_server["Room server"]
  node_server_tcp["TCP service<br/>[tcp.rs]"]
  node_auth["Account service<br/>[auth.rs]"]
  node_db[("Account storage<br/>[db.rs]")]
  node_room["Room state<br/>[room.rs]"]
  node_server_udp["UDP relay<br/>[udp.rs]"]
end

node_user(("Participant"))

node_user -->|"uses"| node_ui
node_ui -->|"invokes"| node_bridge
node_bridge -->|"loads and saves"| node_settings
node_bridge -->|"sends commands"| node_tcp_client
node_tcp_client -->|"controls room"| node_server_tcp
node_tcp_client -->|"encodes messages"| node_tcp_codec
node_server_tcp -->|"decodes messages"| node_tcp_codec
node_server_tcp -->|"handles authentication"| node_auth
node_auth -->|"reads and writes"| node_db
node_server_tcp -->|"manages membership"| node_room
node_capture -->|"processes audio"| node_denoise
node_denoise -->|"filters audio"| node_dsp
node_dsp -->|"detects speech"| node_vad
node_vad -->|"gates encoding"| node_opus
node_opus -->|"encodes voice"| node_udp_client
node_udp_client -->|"encodes packets"| node_udp_codec
node_udp_client -->|"sends media"| node_server_udp
node_server_udp -->|"looks up recipients"| node_room
node_server_udp -->|"relays media"| node_udp_client
node_udp_client -->|"delivers voice"| node_jitter
node_jitter -->|"feeds decoding"| node_opus
node_opus -->|"provides decoded audio"| node_mixer
node_mixer -->|"mixes for output"| node_playback
node_ui -->|"starts sharing"| node_video_capture
node_video_capture -->|"submits frames"| node_bridge
node_bridge -->|"queues video"| node_udp_client
node_udp_client -->|"delivers frames"| node_video_view
node_video_view -->|"renders streams"| node_ui
node_tcp_client -->|"uses message types"| node_messages
node_server_tcp -->|"uses message types"| node_messages
node_udp_client -->|"uses packet types"| node_messages
node_server_udp -->|"uses packet types"| node_messages

click node_ui "https://github.com/chenzhou0071/echoroom/blob/dev/client/ui/app.js"
click node_bridge "https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/bridge.rs"
click node_settings "https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/config.rs"
click node_tcp_client "https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/net/tcp.rs"
click node_capture "https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/capture.rs"
click node_denoise "https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/denoise.rs"
click node_dsp "https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/dsp.rs"
click node_vad "https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/vad.rs"
click node_opus "https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/opus.rs"
click node_udp_client "https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/net/udp.rs"
click node_jitter "https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/jitter.rs"
click node_mixer "https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/mixer.rs"
click node_playback "https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/playback.rs"
click node_video_capture "https://github.com/chenzhou0071/echoroom/blob/dev/client/ui/video_capture.js"
click node_video_view "https://github.com/chenzhou0071/echoroom/blob/dev/client/ui/video_view.js"
click node_messages "https://github.com/chenzhou0071/echoroom/blob/dev/protocol/src/messages.rs"
click node_tcp_codec "https://github.com/chenzhou0071/echoroom/blob/dev/protocol/src/tcp.rs"
click node_udp_codec "https://github.com/chenzhou0071/echoroom/blob/dev/protocol/src/udp.rs"
click node_server_tcp "https://github.com/chenzhou0071/echoroom/blob/dev/server/src/tcp.rs"
click node_auth "https://github.com/chenzhou0071/echoroom/blob/dev/server/src/auth.rs"
click node_db "https://github.com/chenzhou0071/echoroom/blob/dev/server/src/db.rs"
click node_room "https://github.com/chenzhou0071/echoroom/blob/dev/server/src/room.rs"
click node_server_udp "https://github.com/chenzhou0071/echoroom/blob/dev/server/src/udp.rs"

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_bridge,node_settings,node_tcp_client toneBlue
class node_capture,node_denoise,node_dsp,node_vad,node_opus,node_udp_client,node_jitter,node_mixer,node_playback,node_video_capture,node_video_view toneAmber
class node_messages,node_tcp_codec,node_udp_codec toneMint
class node_server_tcp,node_auth,node_db,node_room,node_server_udp toneRose
class node_user toneIndigo
```

## Components

### Desktop client

- [Chat UI](https://github.com/chenzhou0071/echoroom/blob/dev/client/ui/app.js): `client/ui/app.js`
- [UI bridge](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/bridge.rs): `client/src-tauri/src/bridge.rs`
- [Local settings](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/config.rs): `client/src-tauri/src/config.rs`
- [TCP control](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/net/tcp.rs): `client/src-tauri/src/net/tcp.rs`

### Client media

- [Audio capture](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/capture.rs): `client/src-tauri/src/audio/capture.rs`
- [Noise reduction](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/denoise.rs): `client/src-tauri/src/audio/denoise.rs`
- [Audio DSP](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/dsp.rs): `client/src-tauri/src/audio/dsp.rs`
- [Speech detection](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/vad.rs): `client/src-tauri/src/audio/vad.rs`
- [Opus codec](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/opus.rs): `client/src-tauri/src/audio/opus.rs`
- [UDP media](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/net/udp.rs): `client/src-tauri/src/net/udp.rs`
- [Jitter buffer](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/jitter.rs): `client/src-tauri/src/audio/jitter.rs`
- [Audio mixer](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/mixer.rs): `client/src-tauri/src/audio/mixer.rs`
- [Audio playback](https://github.com/chenzhou0071/echoroom/blob/dev/client/src-tauri/src/audio/playback.rs): `client/src-tauri/src/audio/playback.rs`
- [Video capture](https://github.com/chenzhou0071/echoroom/blob/dev/client/ui/video_capture.js): `client/ui/video_capture.js`
- [Video viewer](https://github.com/chenzhou0071/echoroom/blob/dev/client/ui/video_view.js): `client/ui/video_view.js`

### Shared protocol

- [Message types](https://github.com/chenzhou0071/echoroom/blob/dev/protocol/src/messages.rs): `protocol/src/messages.rs`
- [TCP codec](https://github.com/chenzhou0071/echoroom/blob/dev/protocol/src/tcp.rs): `protocol/src/tcp.rs`
- [UDP codec](https://github.com/chenzhou0071/echoroom/blob/dev/protocol/src/udp.rs): `protocol/src/udp.rs`

### Room server

- [TCP service](https://github.com/chenzhou0071/echoroom/blob/dev/server/src/tcp.rs): `server/src/tcp.rs`
- [Account service](https://github.com/chenzhou0071/echoroom/blob/dev/server/src/auth.rs): `server/src/auth.rs`
- [Account storage](https://github.com/chenzhou0071/echoroom/blob/dev/server/src/db.rs): `server/src/db.rs`
- [Room state](https://github.com/chenzhou0071/echoroom/blob/dev/server/src/room.rs): `server/src/room.rs`
- [UDP relay](https://github.com/chenzhou0071/echoroom/blob/dev/server/src/udp.rs): `server/src/udp.rs`

### Other components

- **Participant**

## Connections

- Participant → Chat UI: uses
- Chat UI → UI bridge: invokes
- UI bridge → Local settings: loads and saves (evidence: `client/src-tauri/src/bridge.rs`)
- UI bridge → TCP control: sends commands (evidence: `client/src-tauri/src/bridge.rs`)
- TCP control → TCP service: controls room
- TCP control → TCP codec: encodes messages (evidence: `client/src-tauri/src/net/tcp.rs`)
- TCP service → TCP codec: decodes messages
- TCP service → Account service: handles authentication (evidence: `server/src/tcp.rs`)
- Account service → Account storage: reads and writes (evidence: `server/src/auth.rs`)
- TCP service → Room state: manages membership (evidence: `server/src/tcp.rs`)
- Audio capture → Noise reduction: processes audio
- Noise reduction → Audio DSP: filters audio
- Audio DSP → Speech detection: detects speech
- Speech detection → Opus codec: gates encoding (evidence: `client/src-tauri/src/audio/session.rs`)
- Opus codec → UDP media: encodes voice (evidence: `client/src-tauri/src/net/udp.rs`)
- UDP media → UDP codec: encodes packets (evidence: `client/src-tauri/src/net/udp.rs`)
- UDP media → UDP relay: sends media
- UDP relay → Room state: looks up recipients (evidence: `server/src/udp.rs`)
- UDP relay → UDP media: relays media
- UDP media → Jitter buffer: delivers voice
- Jitter buffer → Opus codec: feeds decoding
- Opus codec → Audio mixer: provides decoded audio
- Audio mixer → Audio playback: mixes for output
- Chat UI → Video capture: starts sharing
- Video capture → UI bridge: submits frames (evidence: `client/src-tauri/src/bridge.rs`)
- UI bridge → UDP media: queues video (evidence: `client/src-tauri/src/bridge.rs`)
- UDP media → Video viewer: delivers frames
- Video viewer → Chat UI: renders streams
- TCP control → Message types: uses message types (evidence: `client/src-tauri/src/net/tcp.rs`)
- TCP service → Message types: uses message types
- UDP media → Message types: uses packet types (evidence: `client/src-tauri/src/net/udp.rs`)
- UDP relay → Message types: uses packet types
