How certifiedcoders/anniexmusic works
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: stream.py Queue and stream · call.py Voice call controller · __main__.py Startup clients · play.py Play commands
Components 17
Bot Runtime
- Startup clients
AnnieXMedia/__main__.py - Bot client
AnnieXMedia/core/bot.py - Assistant clients
AnnieXMedia/core/userbot.py - Runtime configuration
config.py
Music Playback
- Play commands
AnnieXMedia/plugins/play/play.py - Music sources
AnnieXMedia/platforms - Queue and stream
AnnieXMedia/utils/stream/stream.py - Voice call controller
AnnieXMedia/core/call.py
State and Controls
- Playback state
AnnieXMedia/utils/database.py - Inline controls
AnnieXMedia/utils/inline/play.py - Bot settings
AnnieXMedia/plugins/bot/settings.py
Group Features
- Group management
AnnieXMedia/plugins/Manager - Playback admin controls
AnnieXMedia/plugins/admins
Other components
- Telegram user
- Telegram
- Group voice chat
- MongoDB
Connections 19
- Startup clients → Bot client: starts
AnnieXMedia/__main__.py - Startup clients → Assistant clients: starts
AnnieXMedia/__main__.py - Telegram user → Telegram: sends request
- Telegram → Play commands: routes command
- Play commands → Queue and stream: delegates playback
AnnieXMedia/plugins/play/play.py - Queue and stream → Music sources: resolves and downloads
AnnieXMedia/utils/stream/stream.py - Queue and stream → Playback state: updates queue state
AnnieXMedia/utils/stream/stream.py - Queue and stream → Voice call controller: starts playback
AnnieXMedia/utils/stream/stream.py - Voice call controller → Assistant clients: selects assistant
AnnieXMedia/core/call.py - Voice call controller → Group voice chat: plays stream
AnnieXMedia/core/call.py - Assistant clients → Telegram: connects account
AnnieXMedia/core/userbot.py - Playback state → MongoDB: reads and writes
AnnieXMedia/utils/database.py - Play commands → Inline controls: offers controls
AnnieXMedia/plugins/play/play.py - Bot settings → Playback state: stores settings
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
AnnieXMedia/__main__.py