# certifiedcoders/anniexmusic architecture

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

- Interactive diagram: https://gitdiagram.com/certifiedcoders/anniexmusic
- Repository: https://github.com/certifiedcoders/anniexmusic

## Overview

AnnieXMusic is a Telegram group voice-chat music bot. Users submit a track request; the play handler delegates source resolution/download and queue/stream setup, then the call controller drives assistant clients to play audio or video in the voice chat. The repository also provides group administration, bot settings, inline controls, and persistent configuration. The README documents supported music platforms and management features; some plugin implementations were not sampled, so those subsystem links are documented rather than source-verified.

Main entry points: [`AnnieXMedia/utils/stream/stream.py`](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/utils/stream/stream.py) (Queue and stream), [`AnnieXMedia/core/call.py`](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/core/call.py) (Voice call controller), [`AnnieXMedia/__main__.py`](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/__main__.py) (Startup clients), [`AnnieXMedia/plugins/play/play.py`](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/plugins/play/play.py) (Play commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Bot Runtime"]
  node_entry["Startup clients<br/>[__main__.py]"]
  node_app["Bot client<br/>[bot.py]"]
  node_assistants["Assistant clients<br/>[userbot.py]"]
  node_config["Runtime configuration<br/>[config.py]"]
end

subgraph group_music["Music Playback"]
  node_playcmd["Play commands<br/>[play.py]"]
  node_sources["Music sources"]
  node_stream["Queue and stream<br/>[stream.py]"]
  node_calls["Voice call controller<br/>[call.py]"]
end

subgraph group_settings["State and Controls"]
  node_playstate["Playback state<br/>[database.py]"]
  node_inline["Inline controls<br/>[play.py]"]
  node_settingscmd["Bot settings<br/>[settings.py]"]
end

subgraph group_community["Group Features"]
  node_moderation["Group management"]
  node_admincmd["Playback admin controls"]
end

node_user(("Telegram user"))
node_telegram(("Telegram"))
node_voice(("Group voice chat"))
node_mongo[("MongoDB")]

node_entry -->|"starts"| node_app
node_entry -->|"starts"| node_assistants
node_user -->|"sends request"| node_telegram
node_telegram -.->|"routes command"| node_playcmd
node_playcmd -->|"delegates playback"| node_stream
node_stream -->|"resolves and downloads"| node_sources
node_stream -->|"updates queue state"| node_playstate
node_stream -->|"starts playback"| node_calls
node_calls -->|"selects assistant"| node_assistants
node_calls -->|"plays stream"| node_voice
node_assistants -->|"connects account"| node_telegram
node_playstate -->|"reads and writes"| node_mongo
node_playcmd -->|"offers controls"| node_inline
node_settingscmd -->|"stores settings"| node_playstate
node_user -->|"uses group tools"| node_moderation
node_moderation -.->|"manages groups"| node_telegram
node_user -.->|"controls playback"| node_admincmd
node_admincmd -.->|"controls active stream"| node_calls
node_entry -->|"loads configuration"| node_config

click node_entry "https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/__main__.py"
click node_app "https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/core/bot.py"
click node_assistants "https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/core/userbot.py"
click node_playcmd "https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/plugins/play/play.py"
click node_sources "https://github.com/certifiedcoders/anniexmusic/tree/Master/AnnieXMedia/platforms"
click node_stream "https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/utils/stream/stream.py"
click node_calls "https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/core/call.py"
click node_playstate "https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/utils/database.py"
click node_inline "https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/utils/inline/play.py"
click node_settingscmd "https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/plugins/bot/settings.py"
click node_moderation "https://github.com/certifiedcoders/anniexmusic/tree/Master/AnnieXMedia/plugins/Manager"
click node_admincmd "https://github.com/certifiedcoders/anniexmusic/tree/Master/AnnieXMedia/plugins/admins"
click node_config "https://github.com/certifiedcoders/anniexmusic/blob/Master/config.py"

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_entry,node_app,node_assistants,node_config,node_user toneBlue
class node_playcmd,node_sources,node_stream,node_calls,node_mongo toneAmber
class node_playstate,node_inline,node_settingscmd toneMint
class node_moderation,node_admincmd toneRose
class node_telegram,node_voice toneIndigo
```

## Components

### Bot Runtime

- [Startup clients](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/__main__.py): `AnnieXMedia/__main__.py`
- [Bot client](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/core/bot.py): `AnnieXMedia/core/bot.py`
- [Assistant clients](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/core/userbot.py): `AnnieXMedia/core/userbot.py`
- [Runtime configuration](https://github.com/certifiedcoders/anniexmusic/blob/Master/config.py): `config.py`

### Music Playback

- [Play commands](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/plugins/play/play.py): `AnnieXMedia/plugins/play/play.py`
- [Music sources](https://github.com/certifiedcoders/anniexmusic/tree/Master/AnnieXMedia/platforms): `AnnieXMedia/platforms`
- [Queue and stream](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/utils/stream/stream.py): `AnnieXMedia/utils/stream/stream.py`
- [Voice call controller](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/core/call.py): `AnnieXMedia/core/call.py`

### State and Controls

- [Playback state](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/utils/database.py): `AnnieXMedia/utils/database.py`
- [Inline controls](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/utils/inline/play.py): `AnnieXMedia/utils/inline/play.py`
- [Bot settings](https://github.com/certifiedcoders/anniexmusic/blob/Master/AnnieXMedia/plugins/bot/settings.py): `AnnieXMedia/plugins/bot/settings.py`

### Group Features

- [Group management](https://github.com/certifiedcoders/anniexmusic/tree/Master/AnnieXMedia/plugins/Manager): `AnnieXMedia/plugins/Manager`
- [Playback admin controls](https://github.com/certifiedcoders/anniexmusic/tree/Master/AnnieXMedia/plugins/admins): `AnnieXMedia/plugins/admins`

### Other components

- **Telegram user**
- **Telegram**
- **Group voice chat**
- **MongoDB**

## Connections

- Startup clients → Bot client: starts (evidence: `AnnieXMedia/__main__.py`)
- Startup clients → Assistant clients: starts (evidence: `AnnieXMedia/__main__.py`)
- Telegram user → Telegram: sends request
- Telegram → Play commands: routes command
- Play commands → Queue and stream: delegates playback (evidence: `AnnieXMedia/plugins/play/play.py`)
- Queue and stream → Music sources: resolves and downloads (evidence: `AnnieXMedia/utils/stream/stream.py`)
- Queue and stream → Playback state: updates queue state (evidence: `AnnieXMedia/utils/stream/stream.py`)
- Queue and stream → Voice call controller: starts playback (evidence: `AnnieXMedia/utils/stream/stream.py`)
- Voice call controller → Assistant clients: selects assistant (evidence: `AnnieXMedia/core/call.py`)
- Voice call controller → Group voice chat: plays stream (evidence: `AnnieXMedia/core/call.py`)
- Assistant clients → Telegram: connects account (evidence: `AnnieXMedia/core/userbot.py`)
- Playback state → MongoDB: reads and writes (evidence: `AnnieXMedia/utils/database.py`)
- Play commands → Inline controls: offers controls (evidence: `AnnieXMedia/plugins/play/play.py`)
- Bot settings → Playback state: stores settings (evidence: `AnnieXMedia/plugins/bot/settings.py`)
- Telegram user → Group management: uses group tools
- Group management → Telegram: manages groups
- Telegram user → Playback admin controls: controls playback
- Playback admin controls → Voice call controller: controls active stream
- Startup clients → Runtime configuration: loads configuration (evidence: `AnnieXMedia/__main__.py`)
