# mwittrien/betterdiscordaddons architecture

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

## Overview

This repository is a suite of BetterDiscord plugins, supported by a shared BDFDB runtime library. The user-facing workflow is interaction with Discord: plugins hook or patch Discord UI and behavior, then provide features such as local customization, messaging tools, notifications, and media controls. The graph emphasizes the large core plugins and sampled integrations; many other plugins are present in the tree but their implementations were not sampled. Edges are limited to relationships visible in excerpts or stated in the README.

Main entry points: [`Library/0BDFDB.plugin.js`](https://github.com/mwittrien/betterdiscordaddons/blob/master/Library/0BDFDB.plugin.js) (BDFDB library), [`Plugins/Translator/Translator.plugin.js`](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/Translator/Translator.plugin.js) (Message translation), [`Plugins/SpotifyControls/SpotifyControls.plugin.js`](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/SpotifyControls/SpotifyControls.plugin.js) (Spotify controls), [`Plugins/ServerFolders/ServerFolders.plugin.js`](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/ServerFolders/ServerFolders.plugin.js) (Server folders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Shared Runtime"]
  node_bdfdb["BDFDB library<br/>[0BDFDB.plugin.js]"]
end

subgraph group_servers["Server and User UI"]
  node_betterfriends["Friend list"]
  node_serverschannels["Servers as channels"]
  node_editchannels["Edit channels"]
  node_editservers["Edit servers"]
  node_editusers["Edit users"]
  node_serverfolders["Server folders"]
end

subgraph group_messages["Messaging Features"]
  node_personalpins["Message pins"]
  node_pindms["Pinned DMs<br/>[PinDMs.plugin.js]"]
  node_readall["Read notifications"]
  node_spellcheck["Spell check"]
  node_translator["Message translation"]
  node_chatfilter["Chat filter"]
  node_chataliases["Chat aliases"]
end

subgraph group_media["Media and Integrations"]
  node_imageutilities["Image utilities"]
  node_spotify["Spotify controls"]
end

subgraph group_activity["Presence and Notifications"]
  node_notificationsounds["Notification sounds"]
  node_friendnotifications["Friend notifications"]
end

node_user(("Discord user"))
node_discord["Discord client"]

node_user -->|"uses"| node_discord
node_discord -->|"folder interactions"| node_serverfolders
node_discord -->|"DM list events"| node_pindms
node_discord -->|"message menu events"| node_personalpins
node_discord -->|"message actions"| node_translator
node_discord -->|"media interactions"| node_imageutilities
node_discord -->|"playback state"| node_spotify
node_serverfolders -->|"patches utilities"| node_bdfdb
node_pindms -->|"patches and renders"| node_bdfdb
node_personalpins -->|"adds menu actions"| node_bdfdb
node_translator -->|"patches message flows"| node_bdfdb
node_imageutilities -->|"uses media utilities"| node_bdfdb
node_spotify -->|"patches playback UI"| node_bdfdb
node_editchannels -->|"renders edits"| node_bdfdb
node_editusers -->|"renders edits"| node_bdfdb
node_editservers -->|"renders edits"| node_bdfdb
node_translator -.->|"requests translation"| node_discord
node_spotify -.->|"controls playback"| node_discord

click node_bdfdb "https://github.com/mwittrien/betterdiscordaddons/blob/master/Library/0BDFDB.plugin.js"
click node_betterfriends "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/BetterFriendList/BetterFriendList.plugin.js"
click node_serverschannels "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/DisplayServersAsChannels/DisplayServersAsChannels.plugin.js"
click node_editchannels "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/EditChannels/EditChannels.plugin.js"
click node_editservers "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/EditServers/EditServers.plugin.js"
click node_editusers "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/EditUsers/EditUsers.plugin.js"
click node_serverfolders "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/ServerFolders/ServerFolders.plugin.js"
click node_personalpins "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/PersonalPins/PersonalPins.plugin.js"
click node_pindms "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/PinDMs/PinDMs.plugin.js"
click node_readall "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/ReadAllNotificationsButton/ReadAllNotificationsButton.plugin.js"
click node_spellcheck "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/SpellCheck/SpellCheck.plugin.js"
click node_translator "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/Translator/Translator.plugin.js"
click node_imageutilities "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/ImageUtilities/ImageUtilities.plugin.js"
click node_spotify "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/SpotifyControls/SpotifyControls.plugin.js"
click node_notificationsounds "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/NotificationSounds/NotificationSounds.plugin.js"
click node_friendnotifications "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/FriendNotifications/FriendNotifications.plugin.js"
click node_chatfilter "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/ChatFilter/ChatFilter.plugin.js"
click node_chataliases "https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/ChatAliases/ChatAliases.plugin.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_bdfdb,node_user,node_discord toneBlue
class node_betterfriends,node_serverschannels,node_editchannels,node_editservers,node_editusers,node_serverfolders toneAmber
class node_personalpins,node_pindms,node_readall,node_spellcheck,node_translator,node_chatfilter,node_chataliases toneMint
class node_imageutilities,node_spotify toneRose
class node_notificationsounds,node_friendnotifications toneIndigo
```

## Components

### Shared Runtime

- [BDFDB library](https://github.com/mwittrien/betterdiscordaddons/blob/master/Library/0BDFDB.plugin.js): `Library/0BDFDB.plugin.js`

### Server and User UI

- [Friend list](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/BetterFriendList/BetterFriendList.plugin.js): `Plugins/BetterFriendList/BetterFriendList.plugin.js`
- [Servers as channels](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/DisplayServersAsChannels/DisplayServersAsChannels.plugin.js): `Plugins/DisplayServersAsChannels/DisplayServersAsChannels.plugin.js`
- [Edit channels](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/EditChannels/EditChannels.plugin.js): `Plugins/EditChannels/EditChannels.plugin.js`
- [Edit servers](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/EditServers/EditServers.plugin.js): `Plugins/EditServers/EditServers.plugin.js`
- [Edit users](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/EditUsers/EditUsers.plugin.js): `Plugins/EditUsers/EditUsers.plugin.js`
- [Server folders](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/ServerFolders/ServerFolders.plugin.js): `Plugins/ServerFolders/ServerFolders.plugin.js`

### Messaging Features

- [Message pins](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/PersonalPins/PersonalPins.plugin.js): `Plugins/PersonalPins/PersonalPins.plugin.js`
- [Pinned DMs](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/PinDMs/PinDMs.plugin.js): `Plugins/PinDMs/PinDMs.plugin.js`
- [Read notifications](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/ReadAllNotificationsButton/ReadAllNotificationsButton.plugin.js): `Plugins/ReadAllNotificationsButton/ReadAllNotificationsButton.plugin.js`
- [Spell check](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/SpellCheck/SpellCheck.plugin.js): `Plugins/SpellCheck/SpellCheck.plugin.js`
- [Message translation](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/Translator/Translator.plugin.js): `Plugins/Translator/Translator.plugin.js`
- [Chat filter](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/ChatFilter/ChatFilter.plugin.js): `Plugins/ChatFilter/ChatFilter.plugin.js`
- [Chat aliases](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/ChatAliases/ChatAliases.plugin.js): `Plugins/ChatAliases/ChatAliases.plugin.js`

### Media and Integrations

- [Image utilities](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/ImageUtilities/ImageUtilities.plugin.js): `Plugins/ImageUtilities/ImageUtilities.plugin.js`
- [Spotify controls](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/SpotifyControls/SpotifyControls.plugin.js): `Plugins/SpotifyControls/SpotifyControls.plugin.js`

### Presence and Notifications

- [Notification sounds](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/NotificationSounds/NotificationSounds.plugin.js): `Plugins/NotificationSounds/NotificationSounds.plugin.js`
- [Friend notifications](https://github.com/mwittrien/betterdiscordaddons/blob/master/Plugins/FriendNotifications/FriendNotifications.plugin.js): `Plugins/FriendNotifications/FriendNotifications.plugin.js`

### Other components

- **Discord user**
- **Discord client**

## Connections

- Discord user → Discord client: uses
- Discord client → Server folders: folder interactions (evidence: `Plugins/ServerFolders/ServerFolders.plugin.js`)
- Discord client → Pinned DMs: DM list events (evidence: `Plugins/PinDMs/PinDMs.plugin.js`)
- Discord client → Message pins: message menu events (evidence: `Plugins/PersonalPins/PersonalPins.plugin.js`)
- Discord client → Message translation: message actions (evidence: `Plugins/Translator/Translator.plugin.js`)
- Discord client → Image utilities: media interactions (evidence: `Plugins/ImageUtilities/ImageUtilities.plugin.js`)
- Discord client → Spotify controls: playback state (evidence: `Plugins/SpotifyControls/SpotifyControls.plugin.js`)
- Server folders → BDFDB library: patches utilities (evidence: `Plugins/ServerFolders/ServerFolders.plugin.js`)
- Pinned DMs → BDFDB library: patches and renders (evidence: `Plugins/PinDMs/PinDMs.plugin.js`)
- Message pins → BDFDB library: adds menu actions (evidence: `Plugins/PersonalPins/PersonalPins.plugin.js`)
- Message translation → BDFDB library: patches message flows (evidence: `Plugins/Translator/Translator.plugin.js`)
- Image utilities → BDFDB library: uses media utilities (evidence: `Plugins/ImageUtilities/ImageUtilities.plugin.js`)
- Spotify controls → BDFDB library: patches playback UI (evidence: `Plugins/SpotifyControls/SpotifyControls.plugin.js`)
- Edit channels → BDFDB library: renders edits (evidence: `Plugins/EditChannels/EditChannels.plugin.js`)
- Edit users → BDFDB library: renders edits (evidence: `Plugins/EditUsers/EditUsers.plugin.js`)
- Edit servers → BDFDB library: renders edits (evidence: `Plugins/EditServers/EditServers.plugin.js`)
- Message translation → Discord client: requests translation
- Spotify controls → Discord client: controls playback
