# nextcloud/spreed architecture

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

- Interactive diagram: https://gitdiagram.com/nextcloud/spreed
- Repository: https://github.com/nextcloud/spreed

## Overview

Nextcloud Talk is a Nextcloud audio/video conferencing and messaging app. Users open or create a conversation, invite or join participants, then chat and participate in calls; the app also supports federation, polls, integrations and administration. The graph shows the documented product branches and core backend layers. Several frontend and integration paths come from the README or tree rather than sampled implementation, so those relationships are marked unverified where appropriate.

Main entry points: [`src/App.vue`](https://github.com/nextcloud/spreed/blob/main/src/App.vue) (Talk interface), [`lib/Service/ParticipantService.php`](https://github.com/nextcloud/spreed/blob/main/lib/Service/ParticipantService.php) (Participant management), [`lib/Federation/FederationManager.php`](https://github.com/nextcloud/spreed/blob/main/lib/Federation/FederationManager.php) (Federation manager), [`lib/Manager.php`](https://github.com/nextcloud/spreed/blob/main/lib/Manager.php) (Conversation coordination)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_frontend["Talk interface<br/>[App.vue]"]
  node_bootstrap["App registration<br/>[Application.php]"]
end

subgraph group_conversation["Conversations and chat"]
  node_room_api["Room API<br/>[RoomController.php]"]
  node_room_service["Room lifecycle<br/>[RoomService.php]"]
  node_participant["Participant management"]
  node_chat_api["Chat API<br/>[ChatController.php]"]
  node_chat["Messages and threads<br/>[ChatManager.php]"]
  node_polls["Poll experience<br/>[PollManager.vue]"]
end

subgraph group_calls["Calls and signaling"]
  node_call_api["Call API<br/>[CallController.php]"]
  node_signaling["Signaling management<br/>[Manager.php]"]
end

subgraph group_federation["Federation and integrations"]
  node_federation["Federation manager"]
  node_federated_chat["Federated chat proxy<br/>[ChatController.php]"]
  node_matterbridge["Matterbridge sync"]
end

subgraph group_platform["State and services"]
  node_room_state[("Room and attendee state<br/>[Attendee.php]")]
  node_session_state[("Session state<br/>[Session.php]")]
  node_session_service["Session tracking<br/>[SessionService.php]"]
  node_manager["Conversation coordination<br/>[Manager.php]"]
  node_config["Talk configuration<br/>[Config.php]"]
end

node_user(("Talk user"))
node_nextcloud(("Nextcloud platform"))
node_remote_talk(("Remote Talk server"))
node_call_services(("Call services"))

node_user -->|"uses"| node_frontend
node_frontend -.->|"manages rooms"| node_room_api
node_frontend -.->|"sends messages"| node_chat_api
node_frontend -.->|"joins calls"| node_call_api
node_frontend -->|"creates polls"| node_polls
node_bootstrap -->|"registers app"| node_nextcloud
node_room_api -->|"handles lifecycle"| node_room_service
node_room_api -->|"manages membership"| node_participant
node_room_service -->|"adds owner"| node_participant
node_chat_api -->|"handles chat"| node_chat
node_chat -->|"uses attendee data"| node_room_state
node_participant -.->|"reads participants"| node_room_state
node_session_service -->|"reads and writes"| node_session_state
node_session_service -->|"uses attendee"| node_room_state
node_manager -->|"coordinates rooms"| node_room_service
node_manager -->|"coordinates participants"| node_participant
node_manager -->|"uses sessions"| node_session_state
node_call_api -.->|"routes signaling"| node_signaling
node_signaling -->|"reads settings"| node_config
node_call_api -.->|"connects calls"| node_call_services
node_federation -->|"uses room coordination"| node_manager
node_federation -->|"uses membership"| node_participant
node_federation -->|"notifies remote"| node_remote_talk
node_federated_chat -.->|"proxies chat"| node_remote_talk
node_matterbridge -->|"syncs messages"| node_chat
node_frontend -.->|"federated chats"| node_federation
node_frontend -.->|"configures sync"| node_matterbridge
node_frontend -.->|"uses integrations"| node_nextcloud

click node_frontend "https://github.com/nextcloud/spreed/blob/main/src/App.vue"
click node_bootstrap "https://github.com/nextcloud/spreed/blob/main/lib/AppInfo/Application.php"
click node_room_api "https://github.com/nextcloud/spreed/blob/main/lib/Controller/RoomController.php"
click node_room_service "https://github.com/nextcloud/spreed/blob/main/lib/Service/RoomService.php"
click node_participant "https://github.com/nextcloud/spreed/blob/main/lib/Service/ParticipantService.php"
click node_chat_api "https://github.com/nextcloud/spreed/blob/main/lib/Controller/ChatController.php"
click node_chat "https://github.com/nextcloud/spreed/blob/main/lib/Chat/ChatManager.php"
click node_polls "https://github.com/nextcloud/spreed/blob/main/src/components/PollViewer/PollManager.vue"
click node_room_state "https://github.com/nextcloud/spreed/blob/main/lib/Model/Attendee.php"
click node_session_state "https://github.com/nextcloud/spreed/blob/main/lib/Model/Session.php"
click node_session_service "https://github.com/nextcloud/spreed/blob/main/lib/Service/SessionService.php"
click node_manager "https://github.com/nextcloud/spreed/blob/main/lib/Manager.php"
click node_config "https://github.com/nextcloud/spreed/blob/main/lib/Config.php"
click node_call_api "https://github.com/nextcloud/spreed/blob/main/lib/Controller/CallController.php"
click node_signaling "https://github.com/nextcloud/spreed/blob/main/lib/Signaling/Manager.php"
click node_federation "https://github.com/nextcloud/spreed/blob/main/lib/Federation/FederationManager.php"
click node_federated_chat "https://github.com/nextcloud/spreed/blob/main/lib/Federation/Proxy/TalkV1/Controller/ChatController.php"
click node_matterbridge "https://github.com/nextcloud/spreed/blob/main/lib/MatterbridgeManager.php"

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_frontend,node_bootstrap,node_user toneBlue
class node_room_api,node_room_service,node_participant,node_chat_api,node_chat,node_polls toneAmber
class node_call_api,node_signaling,node_remote_talk toneMint
class node_federation,node_federated_chat,node_matterbridge toneRose
class node_room_state,node_session_state,node_session_service,node_manager,node_config,node_nextcloud,node_call_services toneIndigo
```

## Components

### Application entry

- [Talk interface](https://github.com/nextcloud/spreed/blob/main/src/App.vue): `src/App.vue`
- [App registration](https://github.com/nextcloud/spreed/blob/main/lib/AppInfo/Application.php): `lib/AppInfo/Application.php`

### Conversations and chat

- [Room API](https://github.com/nextcloud/spreed/blob/main/lib/Controller/RoomController.php): `lib/Controller/RoomController.php`
- [Room lifecycle](https://github.com/nextcloud/spreed/blob/main/lib/Service/RoomService.php): `lib/Service/RoomService.php`
- [Participant management](https://github.com/nextcloud/spreed/blob/main/lib/Service/ParticipantService.php): `lib/Service/ParticipantService.php`
- [Chat API](https://github.com/nextcloud/spreed/blob/main/lib/Controller/ChatController.php): `lib/Controller/ChatController.php`
- [Messages and threads](https://github.com/nextcloud/spreed/blob/main/lib/Chat/ChatManager.php): `lib/Chat/ChatManager.php`
- [Poll experience](https://github.com/nextcloud/spreed/blob/main/src/components/PollViewer/PollManager.vue): `src/components/PollViewer/PollManager.vue`

### Calls and signaling

- [Call API](https://github.com/nextcloud/spreed/blob/main/lib/Controller/CallController.php): `lib/Controller/CallController.php`
- [Signaling management](https://github.com/nextcloud/spreed/blob/main/lib/Signaling/Manager.php): `lib/Signaling/Manager.php`

### Federation and integrations

- [Federation manager](https://github.com/nextcloud/spreed/blob/main/lib/Federation/FederationManager.php): `lib/Federation/FederationManager.php`
- [Federated chat proxy](https://github.com/nextcloud/spreed/blob/main/lib/Federation/Proxy/TalkV1/Controller/ChatController.php): `lib/Federation/Proxy/TalkV1/Controller/ChatController.php`
- [Matterbridge sync](https://github.com/nextcloud/spreed/blob/main/lib/MatterbridgeManager.php): `lib/MatterbridgeManager.php`

### State and services

- [Room and attendee state](https://github.com/nextcloud/spreed/blob/main/lib/Model/Attendee.php): `lib/Model/Attendee.php`
- [Session state](https://github.com/nextcloud/spreed/blob/main/lib/Model/Session.php): `lib/Model/Session.php`
- [Session tracking](https://github.com/nextcloud/spreed/blob/main/lib/Service/SessionService.php): `lib/Service/SessionService.php`
- [Conversation coordination](https://github.com/nextcloud/spreed/blob/main/lib/Manager.php): `lib/Manager.php`
- [Talk configuration](https://github.com/nextcloud/spreed/blob/main/lib/Config.php): `lib/Config.php`

### Other components

- **Talk user**
- **Nextcloud platform**
- **Remote Talk server**
- **Call services**

## Connections

- Talk user → Talk interface: uses
- Talk interface → Room API: manages rooms
- Talk interface → Chat API: sends messages
- Talk interface → Call API: joins calls
- Talk interface → Poll experience: creates polls (evidence: `src/components/PollViewer/PollManager.vue`)
- App registration → Nextcloud platform: registers app (evidence: `lib/AppInfo/Application.php`)
- Room API → Room lifecycle: handles lifecycle (evidence: `lib/Controller/RoomController.php`)
- Room API → Participant management: manages membership (evidence: `lib/Controller/RoomController.php`)
- Room lifecycle → Participant management: adds owner (evidence: `lib/Service/RoomService.php`)
- Chat API → Messages and threads: handles chat (evidence: `lib/Controller/ChatController.php`)
- Messages and threads → Room and attendee state: uses attendee data (evidence: `lib/Chat/ChatManager.php`)
- Participant management → Room and attendee state: reads participants (evidence: `lib/Service/ParticipantService.php`)
- Session tracking → Session state: reads and writes (evidence: `lib/Service/SessionService.php`)
- Session tracking → Room and attendee state: uses attendee (evidence: `lib/Service/SessionService.php`)
- Conversation coordination → Room lifecycle: coordinates rooms (evidence: `lib/Manager.php`)
- Conversation coordination → Participant management: coordinates participants (evidence: `lib/Manager.php`)
- Conversation coordination → Session state: uses sessions (evidence: `lib/Manager.php`)
- Call API → Signaling management: routes signaling
- Signaling management → Talk configuration: reads settings (evidence: `lib/Signaling/Manager.php`)
- Call API → Call services: connects calls
- Federation manager → Conversation coordination: uses room coordination (evidence: `lib/Federation/FederationManager.php`)
- Federation manager → Participant management: uses membership (evidence: `lib/Federation/FederationManager.php`)
- Federation manager → Remote Talk server: notifies remote (evidence: `lib/Federation/FederationManager.php`)
- Federated chat proxy → Remote Talk server: proxies chat
- Matterbridge sync → Messages and threads: syncs messages (evidence: `lib/MatterbridgeManager.php`)
- Talk interface → Federation manager: federated chats
- Talk interface → Matterbridge sync: configures sync
- Talk interface → Nextcloud platform: uses integrations
