# metinncetinn/funnel-talk architecture

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

## Overview

Funnel Talk is a Windows Electron voice/video and text-chat client for small groups. A user enters with a name or optional Google sign-in, selects a channel, then uses LiveKit for voice/video and screen sharing or the token server for chat and shared files; settings and device-specific audio preferences persist locally. The renderer also provides soundboard, audio controls, themes, and shortcuts. The server implementation is not present in this repository, so its documented responsibilities are represented as an external service; finer chat/server internals are not inferred.

Main entry points: [`renderer/renderer.js`](https://github.com/metinncetinn/funnel-talk/blob/main/renderer/renderer.js) (Channel and session UI), [`main.js`](https://github.com/metinncetinn/funnel-talk/blob/main/main.js) (Electron shell), [`preload.js`](https://github.com/metinncetinn/funnel-talk/blob/main/preload.js) (IPC bridge), [`renderer/lang.js`](https://github.com/metinncetinn/funnel-talk/blob/main/renderer/lang.js) (Localization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop shell"]
  node_shell["Electron shell<br/>[main.js]"]
  node_bridge["IPC bridge<br/>[preload.js]"]
  node_preferences[("Settings and identity<br/>[main.js]")]
end

subgraph group_renderer["Client experience"]
  node_renderer_ui["Channel and session UI<br/>[renderer.js]"]
  node_language["Localization<br/>[lang.js]"]
  node_config["Client configuration<br/>[config.js]"]
  node_chat["Text chat and attachments<br/>[renderer.js]"]
  node_soundboard["Soundboard<br/>[renderer.js]"]
end

subgraph group_realtime["Realtime media"]
  node_media["Voice and screen sharing<br/>[renderer.js]"]
  node_audio["Audio processing<br/>[renderer.js]"]
end

subgraph group_services["External services"]
  node_token_service["Token and content server"]
  node_livekit["LiveKit Cloud"]
  node_google["Google OAuth"]
end

node_user(("Group member"))

node_user -->|"uses"| node_renderer_ui
node_renderer_ui -->|"invokes IPC"| node_bridge
node_bridge -->|"routes IPC"| node_shell
node_shell -->|"reads and writes"| node_preferences
node_shell -->|"sends events"| node_renderer_ui
node_renderer_ui -->|"localizes UI"| node_language
node_renderer_ui -->|"reads config"| node_config
node_renderer_ui -->|"manages session"| node_media
node_media -->|"publishes media"| node_livekit
node_media -->|"processes tracks"| node_audio
node_renderer_ui -->|"provides chat"| node_chat
node_chat -->|"loads and stores"| node_token_service
node_renderer_ui -->|"provides controls"| node_soundboard
node_soundboard -->|"hosts sound files"| node_token_service
node_soundboard -->|"shares channel audio"| node_livekit
node_user -->|"signs in"| node_shell
node_shell -.->|"authenticates optionally"| node_google
node_shell -.->|"requests access token"| node_livekit

click node_shell "https://github.com/metinncetinn/funnel-talk/blob/main/main.js"
click node_bridge "https://github.com/metinncetinn/funnel-talk/blob/main/preload.js"
click node_preferences "https://github.com/metinncetinn/funnel-talk/blob/main/main.js"
click node_renderer_ui "https://github.com/metinncetinn/funnel-talk/blob/main/renderer/renderer.js"
click node_language "https://github.com/metinncetinn/funnel-talk/blob/main/renderer/lang.js"
click node_config "https://github.com/metinncetinn/funnel-talk/blob/main/renderer/config.js"
click node_media "https://github.com/metinncetinn/funnel-talk/blob/main/renderer/renderer.js"
click node_audio "https://github.com/metinncetinn/funnel-talk/blob/main/renderer/renderer.js"
click node_chat "https://github.com/metinncetinn/funnel-talk/blob/main/renderer/renderer.js"
click node_soundboard "https://github.com/metinncetinn/funnel-talk/blob/main/renderer/renderer.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_shell,node_bridge,node_preferences toneBlue
class node_renderer_ui,node_language,node_config,node_chat,node_soundboard toneAmber
class node_media,node_audio toneMint
class node_token_service,node_livekit,node_google toneRose
class node_user toneIndigo
```

## Components

### Desktop shell

- [Electron shell](https://github.com/metinncetinn/funnel-talk/blob/main/main.js): `main.js`
- [IPC bridge](https://github.com/metinncetinn/funnel-talk/blob/main/preload.js): `preload.js`
- [Settings and identity](https://github.com/metinncetinn/funnel-talk/blob/main/main.js): `main.js`

### Client experience

- [Channel and session UI](https://github.com/metinncetinn/funnel-talk/blob/main/renderer/renderer.js): `renderer/renderer.js`
- [Localization](https://github.com/metinncetinn/funnel-talk/blob/main/renderer/lang.js): `renderer/lang.js`
- [Client configuration](https://github.com/metinncetinn/funnel-talk/blob/main/renderer/config.js): `renderer/config.js`
- [Text chat and attachments](https://github.com/metinncetinn/funnel-talk/blob/main/renderer/renderer.js): `renderer/renderer.js`
- [Soundboard](https://github.com/metinncetinn/funnel-talk/blob/main/renderer/renderer.js): `renderer/renderer.js`

### Realtime media

- [Voice and screen sharing](https://github.com/metinncetinn/funnel-talk/blob/main/renderer/renderer.js): `renderer/renderer.js`
- [Audio processing](https://github.com/metinncetinn/funnel-talk/blob/main/renderer/renderer.js): `renderer/renderer.js`

### External services

- **Token and content server**
- **LiveKit Cloud**
- **Google OAuth**

### Other components

- **Group member**

## Connections

- Group member → Channel and session UI: uses
- Channel and session UI → IPC bridge: invokes IPC (evidence: `renderer/renderer.js`)
- IPC bridge → Electron shell: routes IPC (evidence: `preload.js`)
- Electron shell → Settings and identity: reads and writes (evidence: `main.js`)
- Electron shell → Channel and session UI: sends events (evidence: `main.js`)
- Channel and session UI → Localization: localizes UI (evidence: `renderer/lang.js`)
- Channel and session UI → Client configuration: reads config (evidence: `renderer/config.js`)
- Channel and session UI → Voice and screen sharing: manages session (evidence: `renderer/renderer.js`)
- Voice and screen sharing → LiveKit Cloud: publishes media
- Voice and screen sharing → Audio processing: processes tracks (evidence: `renderer/renderer.js`)
- Channel and session UI → Text chat and attachments: provides chat (evidence: `renderer/renderer.js`)
- Text chat and attachments → Token and content server: loads and stores
- Channel and session UI → Soundboard: provides controls (evidence: `renderer/renderer.js`)
- Soundboard → Token and content server: hosts sound files
- Soundboard → LiveKit Cloud: shares channel audio
- Group member → Electron shell: signs in
- Electron shell → Google OAuth: authenticates optionally (evidence: `main.js`)
- Electron shell → LiveKit Cloud: requests access token
