# equicord/equibop architecture

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

- Interactive diagram: https://gitdiagram.com/equicord/equibop
- Repository: https://github.com/equicord/equibop

## Overview

Equibop is an Electron desktop client for Discord with Equicord preinstalled and desktop-specific controls. The principal workflow starts with launch arguments and startup, creates the main window, then exposes settings and client enhancements in the renderer. Main-process services handle tray behavior, update/install support, user assets, and arRPC; screen sharing includes audio-source controls. Shared IPC definitions bridge process boundaries. The source excerpts show several direct module dependencies, but not all runtime wiring, so uncertain links are omitted or marked unverified.

Main entry points: [`src/main/startup.ts`](https://github.com/equicord/equibop/blob/main/src/main/startup.ts) (App Startup), [`src/main/mainWindow.ts`](https://github.com/equicord/equibop/blob/main/src/main/mainWindow.ts) (Main Window), [`src/main/tray.ts`](https://github.com/equicord/equibop/blob/main/src/main/tray.ts) (Tray Controls), [`src/renderer/index.ts`](https://github.com/equicord/equibop/blob/main/src/renderer/index.ts) (Renderer Entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launch["Launch and Window"]
  node_cli["Launch Arguments<br/>[cli.ts]"]
  node_startup["App Startup<br/>[startup.ts]"]
  node_window["Main Window<br/>[mainWindow.ts]"]
end

subgraph group_desktop["Desktop Services"]
  node_settings[("Settings Store<br/>[settings.ts]")]
  node_tray["Tray Controls<br/>[tray.ts]"]
  node_assets["User Assets<br/>[userAssets.ts]"]
  node_updater["Updater<br/>[updater.ts]"]
  node_vencord["Equicord Loader<br/>[vencordLoader.ts]"]
  node_rpc["arRPC Service<br/>[index.ts]"]
  node_native["Linux Native Helper<br/>[libvesktop.cc]"]
end

subgraph group_client["Client Experience"]
  node_renderer["Renderer Entry<br/>[index.ts]"]
  node_settingsui["Settings UI<br/>[Settings.tsx]"]
  node_screen["Screen Share Picker"]
  node_patches["Discord Enhancements"]
end

subgraph group_bridge["Process Bridge"]
  node_events["IPC Event Contract<br/>[IpcEvents.ts]"]
  node_preload["Preload API<br/>[VesktopNative.ts]"]
  node_mainipc["Main IPC Commands<br/>[ipcCommands.ts]"]
  node_rendereripc["Renderer IPC Commands<br/>[ipcCommands.ts]"]
end

node_user(("User"))
node_discord(("Discord Service"))

node_user -->|"launches with"| node_cli
node_cli -->|"configures launch"| node_startup
node_startup -->|"creates window"| node_window
node_startup -->|"loads settings"| node_settings
node_startup -->|"initializes updater"| node_updater
node_startup -->|"initializes assets"| node_assets
node_window -->|"manages tray"| node_tray
node_window -->|"cleans up"| node_rpc
node_window -->|"downloads client"| node_vencord
node_tray -->|"resolves icons"| node_assets
node_tray -->|"repairs install"| node_vencord
node_renderer -->|"registers settings"| node_settingsui
node_renderer -->|"loads enhancements"| node_patches
node_settingsui -.->|"edits preferences"| node_settings
node_rendereripc -->|"opens picker"| node_screen
node_preload -->|"uses contract"| node_events
node_mainipc -.->|"uses contract"| node_events
node_rendereripc -.->|"uses contract"| node_events
node_renderer -->|"uses native API"| node_preload
node_discord -.->|"hosts client in"| node_window
node_native -.->|"supports Linux tray"| node_tray
node_user -.->|"selects stream"| node_screen

click node_cli "https://github.com/equicord/equibop/blob/main/src/main/cli.ts"
click node_startup "https://github.com/equicord/equibop/blob/main/src/main/startup.ts"
click node_window "https://github.com/equicord/equibop/blob/main/src/main/mainWindow.ts"
click node_settings "https://github.com/equicord/equibop/blob/main/src/main/settings.ts"
click node_tray "https://github.com/equicord/equibop/blob/main/src/main/tray.ts"
click node_assets "https://github.com/equicord/equibop/blob/main/src/main/userAssets.ts"
click node_updater "https://github.com/equicord/equibop/blob/main/src/main/updater.ts"
click node_vencord "https://github.com/equicord/equibop/blob/main/src/main/utils/vencordLoader.ts"
click node_rpc "https://github.com/equicord/equibop/blob/main/src/main/arrpc/index.ts"
click node_native "https://github.com/equicord/equibop/blob/main/packages/libvesktop/src/libvesktop.cc"
click node_renderer "https://github.com/equicord/equibop/blob/main/src/renderer/index.ts"
click node_settingsui "https://github.com/equicord/equibop/blob/main/src/renderer/components/settings/Settings.tsx"
click node_screen "https://github.com/equicord/equibop/blob/main/src/renderer/components/ScreenSharePicker.tsx"
click node_patches "https://github.com/equicord/equibop/tree/main/src/renderer/patches"
click node_events "https://github.com/equicord/equibop/blob/main/src/shared/IpcEvents.ts"
click node_preload "https://github.com/equicord/equibop/blob/main/src/preload/VesktopNative.ts"
click node_mainipc "https://github.com/equicord/equibop/blob/main/src/main/ipcCommands.ts"
click node_rendereripc "https://github.com/equicord/equibop/blob/main/src/renderer/ipcCommands.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_cli,node_startup,node_window,node_user toneBlue
class node_settings,node_tray,node_assets,node_updater,node_vencord,node_rpc,node_native toneAmber
class node_renderer,node_settingsui,node_screen,node_patches toneMint
class node_events,node_preload,node_mainipc,node_rendereripc toneRose
class node_discord toneIndigo
```

## Components

### Launch and Window

- [Launch Arguments](https://github.com/equicord/equibop/blob/main/src/main/cli.ts): `src/main/cli.ts`
- [App Startup](https://github.com/equicord/equibop/blob/main/src/main/startup.ts): `src/main/startup.ts`
- [Main Window](https://github.com/equicord/equibop/blob/main/src/main/mainWindow.ts): `src/main/mainWindow.ts`

### Desktop Services

- [Settings Store](https://github.com/equicord/equibop/blob/main/src/main/settings.ts): `src/main/settings.ts`
- [Tray Controls](https://github.com/equicord/equibop/blob/main/src/main/tray.ts): `src/main/tray.ts`
- [User Assets](https://github.com/equicord/equibop/blob/main/src/main/userAssets.ts): `src/main/userAssets.ts`
- [Updater](https://github.com/equicord/equibop/blob/main/src/main/updater.ts): `src/main/updater.ts`
- [Equicord Loader](https://github.com/equicord/equibop/blob/main/src/main/utils/vencordLoader.ts): `src/main/utils/vencordLoader.ts`
- [arRPC Service](https://github.com/equicord/equibop/blob/main/src/main/arrpc/index.ts): `src/main/arrpc/index.ts`
- [Linux Native Helper](https://github.com/equicord/equibop/blob/main/packages/libvesktop/src/libvesktop.cc): `packages/libvesktop/src/libvesktop.cc`

### Client Experience

- [Renderer Entry](https://github.com/equicord/equibop/blob/main/src/renderer/index.ts): `src/renderer/index.ts`
- [Settings UI](https://github.com/equicord/equibop/blob/main/src/renderer/components/settings/Settings.tsx): `src/renderer/components/settings/Settings.tsx`
- [Screen Share Picker](https://github.com/equicord/equibop/blob/main/src/renderer/components/ScreenSharePicker.tsx): `src/renderer/components/ScreenSharePicker.tsx`
- [Discord Enhancements](https://github.com/equicord/equibop/tree/main/src/renderer/patches): `src/renderer/patches`

### Process Bridge

- [IPC Event Contract](https://github.com/equicord/equibop/blob/main/src/shared/IpcEvents.ts): `src/shared/IpcEvents.ts`
- [Preload API](https://github.com/equicord/equibop/blob/main/src/preload/VesktopNative.ts): `src/preload/VesktopNative.ts`
- [Main IPC Commands](https://github.com/equicord/equibop/blob/main/src/main/ipcCommands.ts): `src/main/ipcCommands.ts`
- [Renderer IPC Commands](https://github.com/equicord/equibop/blob/main/src/renderer/ipcCommands.ts): `src/renderer/ipcCommands.ts`

### Other components

- **User**
- **Discord Service**

## Connections

- User → Launch Arguments: launches with (evidence: `README.md`)
- Launch Arguments → App Startup: configures launch (evidence: `src/main/index.ts`)
- App Startup → Main Window: creates window (evidence: `src/main/startup.ts`)
- App Startup → Settings Store: loads settings (evidence: `src/main/startup.ts`)
- App Startup → Updater: initializes updater (evidence: `src/main/startup.ts`)
- App Startup → User Assets: initializes assets (evidence: `src/main/startup.ts`)
- Main Window → Tray Controls: manages tray (evidence: `src/main/mainWindow.ts`)
- Main Window → arRPC Service: cleans up (evidence: `src/main/mainWindow.ts`)
- Main Window → Equicord Loader: downloads client (evidence: `src/main/mainWindow.ts`)
- Tray Controls → User Assets: resolves icons (evidence: `src/main/tray.ts`)
- Tray Controls → Equicord Loader: repairs install (evidence: `src/main/tray.ts`)
- Renderer Entry → Settings UI: registers settings (evidence: `src/renderer/index.ts`)
- Renderer Entry → Discord Enhancements: loads enhancements (evidence: `src/renderer/index.ts`)
- Settings UI → Settings Store: edits preferences
- Renderer IPC Commands → Screen Share Picker: opens picker (evidence: `src/renderer/ipcCommands.ts`)
- Preload API → IPC Event Contract: uses contract (evidence: `src/preload/VesktopNative.ts`)
- Main IPC Commands → IPC Event Contract: uses contract
- Renderer IPC Commands → IPC Event Contract: uses contract
- Renderer Entry → Preload API: uses native API (evidence: `src/renderer/index.ts`)
- Discord Service → Main Window: hosts client in
- Linux Native Helper → Tray Controls: supports Linux tray
- User → Screen Share Picker: selects stream
