# darknessiv4/libertad architecture

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

- Interactive diagram: https://gitdiagram.com/darknessiv4/libertad
- Repository: https://github.com/darknessiv4/libertad

## Overview

Libertad is a desktop voice-and-community client for Mumble, with a separate serverless friend-call network. The primary workflow is to open the app, connect to a Mumble server, and use its channels for voice and chat; users can also share media and watch together. Direct friend calls form a distinct path that does not depend on Mumble. The graph combines sampled call sites and SOURCE INDEX references with README-documented capabilities; unsampled internals are represented only where their paths are known.

Main entry points: [`src/lib/session.svelte.ts`](https://github.com/darknessiv4/libertad/blob/main/src/lib/session.svelte.ts) (Session manager), [`src/lib/audio/voice.svelte.ts`](https://github.com/darknessiv4/libertad/blob/main/src/lib/audio/voice.svelte.ts) (Voice engine), [`src/App.svelte`](https://github.com/darknessiv4/libertad/blob/main/src/App.svelte) (Application shell), [`src/lib/watch-together.svelte.ts`](https://github.com/darknessiv4/libertad/blob/main/src/lib/watch-together.svelte.ts) (Watch Together)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and interface"]
  node_app["Application shell<br/>[App.svelte]"]
  node_chat["Chat interface<br/>[Chat.svelte]"]
  node_rooms["Rooms interface<br/>[Rooms.svelte]"]
end

subgraph group_mumble["Mumble sessions"]
  node_session["Session manager<br/>[session.svelte.ts]"]
  node_client["Mumble protocol client<br/>[client.ts]"]
  node_transport["Secure transport<br/>[transport.ts]"]
  node_voice["Voice engine<br/>[voice.svelte.ts]"]
end

subgraph group_media["Media and sharing"]
  node_share["Screen sharing<br/>[share.svelte.ts]"]
  node_watch["Watch Together"]
  node_filetransfer["Peer file transfer<br/>[file-transfer.ts]"]
  node_torrent["Torrent playback<br/>[torrent-meta.ts]"]
  node_search["Media search<br/>[search.ts]"]
  node_subtitles["Subtitles<br/>[subtitles.ts]"]
end

subgraph group_friends["Friend network"]
  node_p2pstore["Friend and call state<br/>[p2p.svelte.ts]"]
  node_p2pwire["Friend call protocol<br/>[p2p-wire.ts]"]
  node_electronp2p["Direct-call service<br/>[p2p.ts]"]
end

subgraph group_desktop["Desktop and state"]
  node_storage[("Settings storage<br/>[storage.ts]")]
  node_native["Desktop bridge<br/>[native.ts]"]
  node_main["Electron main process<br/>[main.ts]"]
  node_sounds["Notification sounds<br/>[sounds.svelte.ts]"]
  node_profiles["Public profiles<br/>[profiles.ts]"]
end

node_user(("User"))

node_user -->|"opens"| node_app
node_app -->|"renders"| node_chat
node_app -->|"offers"| node_rooms
node_user -->|"connects"| node_session
node_session -->|"opens transport"| node_native
node_session -->|"uses"| node_client
node_client -->|"uses"| node_transport
node_session -->|"coordinates"| node_share
node_session -->|"coordinates"| node_watch
node_watch -->|"uses metadata"| node_torrent
node_watch -->|"streams files"| node_filetransfer
node_search -->|"reads metadata"| node_torrent
node_user -->|"talks"| node_voice
node_voice -->|"sends voice"| node_client
node_user -->|"calls friends"| node_p2pstore
node_p2pstore -->|"uses protocol"| node_p2pwire
node_p2pstore -.->|"requests calls"| node_electronp2p
node_voice -->|"persists voice settings"| node_storage
node_sounds -->|"loads settings"| node_storage
node_sounds -->|"selects output"| node_voice
node_native -.->|"bridges desktop APIs"| node_main
node_main -->|"registers service"| node_profiles
node_user -->|"uses subtitles"| node_subtitles

click node_app "https://github.com/darknessiv4/libertad/blob/main/src/App.svelte"
click node_chat "https://github.com/darknessiv4/libertad/blob/main/src/ui/Chat.svelte"
click node_rooms "https://github.com/darknessiv4/libertad/blob/main/src/ui2/Rooms.svelte"
click node_session "https://github.com/darknessiv4/libertad/blob/main/src/lib/session.svelte.ts"
click node_client "https://github.com/darknessiv4/libertad/blob/main/src/core/client.ts"
click node_transport "https://github.com/darknessiv4/libertad/blob/main/src/core/transport.ts"
click node_voice "https://github.com/darknessiv4/libertad/blob/main/src/lib/audio/voice.svelte.ts"
click node_share "https://github.com/darknessiv4/libertad/blob/main/src/lib/share.svelte.ts"
click node_watch "https://github.com/darknessiv4/libertad/blob/main/src/lib/watch-together.svelte.ts"
click node_filetransfer "https://github.com/darknessiv4/libertad/blob/main/src/core/file-transfer.ts"
click node_torrent "https://github.com/darknessiv4/libertad/blob/main/src/core/torrent-meta.ts"
click node_search "https://github.com/darknessiv4/libertad/blob/main/src/core/search.ts"
click node_p2pstore "https://github.com/darknessiv4/libertad/blob/main/src/lib/p2p.svelte.ts"
click node_p2pwire "https://github.com/darknessiv4/libertad/blob/main/src/core/p2p-wire.ts"
click node_electronp2p "https://github.com/darknessiv4/libertad/blob/main/electron/p2p.ts"
click node_storage "https://github.com/darknessiv4/libertad/blob/main/src/lib/storage.ts"
click node_native "https://github.com/darknessiv4/libertad/blob/main/src/lib/native.ts"
click node_main "https://github.com/darknessiv4/libertad/blob/main/electron/main.ts"
click node_sounds "https://github.com/darknessiv4/libertad/blob/main/src/lib/audio/sounds.svelte.ts"
click node_profiles "https://github.com/darknessiv4/libertad/blob/main/electron/profiles.ts"
click node_subtitles "https://github.com/darknessiv4/libertad/blob/main/electron/subtitles.ts"

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_app,node_chat,node_rooms,node_user toneBlue
class node_session,node_client,node_transport,node_voice toneAmber
class node_share,node_watch,node_filetransfer,node_torrent,node_search,node_subtitles toneMint
class node_p2pstore,node_p2pwire,node_electronp2p toneRose
class node_storage,node_native,node_main,node_sounds,node_profiles toneIndigo
```

## Components

### App and interface

- [Application shell](https://github.com/darknessiv4/libertad/blob/main/src/App.svelte): `src/App.svelte`
- [Chat interface](https://github.com/darknessiv4/libertad/blob/main/src/ui/Chat.svelte): `src/ui/Chat.svelte`
- [Rooms interface](https://github.com/darknessiv4/libertad/blob/main/src/ui2/Rooms.svelte): `src/ui2/Rooms.svelte`

### Mumble sessions

- [Session manager](https://github.com/darknessiv4/libertad/blob/main/src/lib/session.svelte.ts): `src/lib/session.svelte.ts`
- [Mumble protocol client](https://github.com/darknessiv4/libertad/blob/main/src/core/client.ts): `src/core/client.ts`
- [Secure transport](https://github.com/darknessiv4/libertad/blob/main/src/core/transport.ts): `src/core/transport.ts`
- [Voice engine](https://github.com/darknessiv4/libertad/blob/main/src/lib/audio/voice.svelte.ts): `src/lib/audio/voice.svelte.ts`

### Media and sharing

- [Screen sharing](https://github.com/darknessiv4/libertad/blob/main/src/lib/share.svelte.ts): `src/lib/share.svelte.ts`
- [Watch Together](https://github.com/darknessiv4/libertad/blob/main/src/lib/watch-together.svelte.ts): `src/lib/watch-together.svelte.ts`
- [Peer file transfer](https://github.com/darknessiv4/libertad/blob/main/src/core/file-transfer.ts): `src/core/file-transfer.ts`
- [Torrent playback](https://github.com/darknessiv4/libertad/blob/main/src/core/torrent-meta.ts): `src/core/torrent-meta.ts`
- [Media search](https://github.com/darknessiv4/libertad/blob/main/src/core/search.ts): `src/core/search.ts`
- [Subtitles](https://github.com/darknessiv4/libertad/blob/main/electron/subtitles.ts): `electron/subtitles.ts`

### Friend network

- [Friend and call state](https://github.com/darknessiv4/libertad/blob/main/src/lib/p2p.svelte.ts): `src/lib/p2p.svelte.ts`
- [Friend call protocol](https://github.com/darknessiv4/libertad/blob/main/src/core/p2p-wire.ts): `src/core/p2p-wire.ts`
- [Direct-call service](https://github.com/darknessiv4/libertad/blob/main/electron/p2p.ts): `electron/p2p.ts`

### Desktop and state

- [Settings storage](https://github.com/darknessiv4/libertad/blob/main/src/lib/storage.ts): `src/lib/storage.ts`
- [Desktop bridge](https://github.com/darknessiv4/libertad/blob/main/src/lib/native.ts): `src/lib/native.ts`
- [Electron main process](https://github.com/darknessiv4/libertad/blob/main/electron/main.ts): `electron/main.ts`
- [Notification sounds](https://github.com/darknessiv4/libertad/blob/main/src/lib/audio/sounds.svelte.ts): `src/lib/audio/sounds.svelte.ts`
- [Public profiles](https://github.com/darknessiv4/libertad/blob/main/electron/profiles.ts): `electron/profiles.ts`

### Other components

- **User**

## Connections

- User → Application shell: opens
- Application shell → Chat interface: renders (evidence: `src/App.svelte`)
- Application shell → Rooms interface: offers
- User → Session manager: connects
- Session manager → Desktop bridge: opens transport (evidence: `src/lib/session.svelte.ts`)
- Session manager → Mumble protocol client: uses (evidence: `src/lib/session.svelte.ts`)
- Mumble protocol client → Secure transport: uses (evidence: `src/core/client.ts`)
- Session manager → Screen sharing: coordinates (evidence: `src/lib/session.svelte.ts`)
- Session manager → Watch Together: coordinates (evidence: `src/lib/session.svelte.ts`)
- Watch Together → Torrent playback: uses metadata (evidence: `src/lib/watch-together.svelte.ts`)
- Watch Together → Peer file transfer: streams files (evidence: `src/lib/watch-together.svelte.ts`)
- Media search → Torrent playback: reads metadata (evidence: `src/core/search.ts`)
- User → Voice engine: talks
- Voice engine → Mumble protocol client: sends voice (evidence: `src/lib/audio/voice.svelte.ts`)
- User → Friend and call state: calls friends
- Friend and call state → Friend call protocol: uses protocol (evidence: `src/lib/p2p.svelte.ts`)
- Friend and call state → Direct-call service: requests calls
- Voice engine → Settings storage: persists voice settings (evidence: `src/lib/audio/voice.svelte.ts`)
- Notification sounds → Settings storage: loads settings (evidence: `src/lib/audio/sounds.svelte.ts`)
- Notification sounds → Voice engine: selects output (evidence: `src/lib/audio/sounds.svelte.ts`)
- Desktop bridge → Electron main process: bridges desktop APIs
- Electron main process → Public profiles: registers service (evidence: `electron/main.ts`)
- User → Subtitles: uses subtitles
