# miroslavpejic85/mirotalk architecture

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

## Overview

MiroTalk P2P is a self-hosted browser video-conferencing application. A participant enters a room, the browser establishes peer-to-peer WebRTC communication, and the Node server supplies room signaling and supporting services. The README documents recording, chat, whiteboard, file sharing, authentication, REST APIs, and integrations; several client features are represented at their available source paths because their runtime wiring was not shown. Edges reflect explicit README claims or imports/calls visible in the supplied excerpts and source index; unverified client wiring is omitted.

Main entry points: [`app/src/server.js`](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/server.js) (Conference server), [`public/js/client.js`](https://github.com/miroslavpejic85/mirotalk/blob/master/public/js/client.js) (Conference client), [`app/src/mattermost.js`](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/mattermost.js) (Mattermost integration), [`app/src/api.js`](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/api.js) (API services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser experience"]
  node_browser["Conference client<br/>[client.js]"]
  node_media["Media and video<br/>[videoDrawing.js]"]
  node_room_ui["Room controls<br/>[buttons.js]"]
  node_transcription_ui["Transcription UI"]
end

subgraph group_server["Conference server"]
  node_server["Conference server<br/>[server.js]"]
  node_room_signaling["Room signaling<br/>[server.js]"]
  node_html["Page rendering<br/>[htmlInjector.js]"]
  node_logging["Logging<br/>[logs.js]"]
end

subgraph group_security["Security and identity"]
  node_validation["Input validation<br/>[validate.js]"]
  node_sanitization["XSS sanitization<br/>[xss.js]"]
  node_tokens["Token management<br/>[tokenManager.js]"]
  node_embed["Embed headers<br/>[embedHeaders.js]"]
end

subgraph group_integrations["Integrations"]
  node_mattermost["Mattermost integration<br/>[mattermost.js]"]
  node_email["Email notifications<br/>[nodemailer.js]"]
  node_whisper["Whisper helpers<br/>[whisper.js]"]
end

subgraph group_api["REST API"]
  node_rest["REST handlers"]
  node_api_service["API services<br/>[api.js]"]
end

node_participant(("Participant"))
node_mattermost_service["Mattermost"]
node_transcription_service["Transcription service"]
node_peers(("Peer participants"))

node_participant -->|"joins room"| node_browser
node_browser -->|"uses media"| node_media
node_media -->|"connects peer-to-peer"| node_peers
node_browser -.->|"uses controls"| node_room_ui
node_browser -.->|"uses transcription"| node_transcription_ui
node_server -.->|"handles signaling"| node_room_signaling
node_server -->|"imports"| node_html
node_server -->|"imports"| node_validation
node_server -->|"imports"| node_sanitization
node_server -->|"imports"| node_embed
node_server -->|"imports"| node_api_service
node_server -->|"imports"| node_mattermost
node_server -->|"imports"| node_email
node_server -->|"imports"| node_whisper
node_server -->|"imports"| node_logging
node_validation -->|"imports"| node_sanitization
node_mattermost -->|"uses tokens"| node_tokens
node_mattermost -->|"calls API"| node_mattermost_service
node_rest -.->|"provides REST API"| node_api_service
node_api_service -->|"creates join URLs"| node_participant
node_transcription_ui -->|"requests transcription"| node_transcription_service
node_server -->|"uploads audio"| node_transcription_service
node_server -->|"sends event alerts"| node_email

click node_browser "https://github.com/miroslavpejic85/mirotalk/blob/master/public/js/client.js"
click node_media "https://github.com/miroslavpejic85/mirotalk/blob/master/public/js/videoDrawing.js"
click node_room_ui "https://github.com/miroslavpejic85/mirotalk/blob/master/public/js/buttons.js"
click node_transcription_ui "https://github.com/miroslavpejic85/mirotalk/blob/master/public/js/whisperTranscription.js"
click node_server "https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/server.js"
click node_room_signaling "https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/server.js"
click node_html "https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/htmlInjector.js"
click node_logging "https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/logs.js"
click node_validation "https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/validate.js"
click node_sanitization "https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/xss.js"
click node_tokens "https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/tokenManager.js"
click node_embed "https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/middleware/embedHeaders.js"
click node_rest "https://github.com/miroslavpejic85/mirotalk/tree/master/app/api"
click node_api_service "https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/api.js"
click node_mattermost "https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/mattermost.js"
click node_email "https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/lib/nodemailer.js"
click node_whisper "https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/lib/whisper.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_browser,node_media,node_room_ui,node_transcription_ui toneBlue
class node_server,node_room_signaling,node_html,node_logging toneAmber
class node_validation,node_sanitization,node_tokens,node_embed toneMint
class node_mattermost,node_email,node_whisper toneRose
class node_rest,node_api_service,node_participant,node_mattermost_service,node_transcription_service,node_peers toneIndigo
```

## Components

### Browser experience

- [Conference client](https://github.com/miroslavpejic85/mirotalk/blob/master/public/js/client.js): `public/js/client.js`
- [Media and video](https://github.com/miroslavpejic85/mirotalk/blob/master/public/js/videoDrawing.js): `public/js/videoDrawing.js`
- [Room controls](https://github.com/miroslavpejic85/mirotalk/blob/master/public/js/buttons.js): `public/js/buttons.js`
- [Transcription UI](https://github.com/miroslavpejic85/mirotalk/blob/master/public/js/whisperTranscription.js): `public/js/whisperTranscription.js`

### Conference server

- [Conference server](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/server.js): `app/src/server.js`
- [Room signaling](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/server.js): `app/src/server.js`
- [Page rendering](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/htmlInjector.js): `app/src/htmlInjector.js`
- [Logging](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/logs.js): `app/src/logs.js`

### Security and identity

- [Input validation](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/validate.js): `app/src/validate.js`
- [XSS sanitization](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/xss.js): `app/src/xss.js`
- [Token management](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/tokenManager.js): `app/src/tokenManager.js`
- [Embed headers](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/middleware/embedHeaders.js): `app/src/middleware/embedHeaders.js`

### Integrations

- [Mattermost integration](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/mattermost.js): `app/src/mattermost.js`
- [Email notifications](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/lib/nodemailer.js): `app/src/lib/nodemailer.js`
- [Whisper helpers](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/lib/whisper.js): `app/src/lib/whisper.js`

### REST API

- [REST handlers](https://github.com/miroslavpejic85/mirotalk/tree/master/app/api): `app/api`
- [API services](https://github.com/miroslavpejic85/mirotalk/blob/master/app/src/api.js): `app/src/api.js`

### Other components

- **Participant**
- **Mattermost**
- **Transcription service**
- **Peer participants**

## Connections

- Participant → Conference client: joins room (evidence: `README.md`)
- Conference client → Media and video: uses media (evidence: `README.md`)
- Media and video → Peer participants: connects peer-to-peer (evidence: `README.md`)
- Conference client → Room controls: uses controls
- Conference client → Transcription UI: uses transcription
- Conference server → Room signaling: handles signaling (evidence: `app/src/server.js`)
- Conference server → Page rendering: imports (evidence: `app/src/server.js`)
- Conference server → Input validation: imports (evidence: `app/src/server.js`)
- Conference server → XSS sanitization: imports (evidence: `app/src/server.js`)
- Conference server → Embed headers: imports (evidence: `app/src/server.js`)
- Conference server → API services: imports (evidence: `app/src/server.js`)
- Conference server → Mattermost integration: imports (evidence: `app/src/server.js`)
- Conference server → Email notifications: imports (evidence: `app/src/server.js`)
- Conference server → Whisper helpers: imports (evidence: `app/src/server.js`)
- Conference server → Logging: imports (evidence: `app/src/server.js`)
- Input validation → XSS sanitization: imports (evidence: `app/src/validate.js`)
- Mattermost integration → Token management: uses tokens (evidence: `app/src/mattermost.js`)
- Mattermost integration → Mattermost: calls API (evidence: `README.md`)
- REST handlers → API services: provides REST API
- API services → Participant: creates join URLs (evidence: `app/src/api.js`)
- Transcription UI → Transcription service: requests transcription (evidence: `README.md`)
- Conference server → Transcription service: uploads audio (evidence: `app/src/server.js`)
- Conference server → Email notifications: sends event alerts (evidence: `app/src/lib/nodemailer.js`)
