How umutxyp/musicbot works
Beatra is a Discord music bot: users issue slash commands or use playback controls; the bot resolves tracks and playlists through music providers, queues and plays audio in a voice channel, and updates localized embeds. The graph also preserves lyrics, autoplay, persistent guild language and player state, and playback recovery. Edges follow the shown imports and calls or documented capabilities; unsampled implementation details are represented only where the README documents them.
Main entry points: MusicPlayer.js Music player · play.js Play command · LanguageManager.js Language manager · index.js Bot bootstrap
Components 27
Discord experience
- Bot bootstrap
index.js - Command loader
src/commandLoader.js - Play command
commands/play.js - Search command
commands/search.js - Now Playing command
commands/nowplaying.js - Language command
commands/language.js - Help command
commands/help.js - Button controls
events/buttonHandler.js - Modal controls
events/modalHandler.js
Playback engine
- Music player
src/MusicPlayer.js - Playback embeds
src/MusicEmbedManager.js - Lyrics manager
src/LyricsManager.js
Music sources
- YouTube provider
src/YouTube.js - Spotify provider
src/Spotify.js - SoundCloud provider
src/SoundCloud.js - Direct-link provider
src/DirectLink.js
State and localization
- Language manager
src/LanguageManager.js - Player state
src/PlayerStateManager.js - Error handler
src/ErrorHandler.js - Bot configuration
config.js
Other components
- Discord user
- Discord
- Genius lyrics
- LRCLIB lyrics
- Guild language JSON
database/languages.json - Player state JSON
database/playerState.json - Local audio cache
Connections 41
- Discord user → Discord: issues commands
README.md - Discord → Bot bootstrap: delivers interactions
index.js - Bot bootstrap → Command loader: loads commands
index.js - Bot bootstrap → Player state: restores state
index.js - Bot bootstrap → Music player: wires players
index.js - Bot bootstrap → Playback embeds: wires embeds
index.js - Command loader → Play command: registers command
src/commandLoader.js - Play command → Music player: queues tracks
commands/play.js - Play command → Playback embeds: updates playback UI
commands/play.js - Play command → YouTube provider: resolves tracks
commands/play.js - Play command → Spotify provider: resolves tracks
commands/play.js - Play command → SoundCloud provider: resolves tracks
commands/play.js - Play command → Direct-link provider: resolves links
commands/play.js - Play command → Language manager: gets translations
commands/play.js - Play command → Error handler: formats errors
commands/play.js - Search command → YouTube provider: searches tracks
commands/search.js - Search command → Language manager: gets translations
commands/search.js - Now Playing command → Language manager: gets translations
commands/nowplaying.js - Language command → Language manager: sets guild language
commands/language.js - Help command → Language manager: gets translations
commands/help.js - Button controls → Music player: controls playback
events/buttonHandler.js - Button controls → Playback embeds: refreshes embeds
events/buttonHandler.js - Button controls → Lyrics manager: requests lyrics
events/buttonHandler.js - Button controls → Language manager: gets translations
events/buttonHandler.js - Modal controls → Language manager: gets translations
events/modalHandler.js - Music player → YouTube provider: downloads audio
src/MusicPlayer.js - Music player → Spotify provider: resolves equivalents
src/MusicPlayer.js - Music player → SoundCloud provider: resolves equivalents
src/MusicPlayer.js - Music player → Direct-link provider: gets stream info
src/MusicPlayer.js - Music player → Player state: persists playback
src/MusicPlayer.js - Music player → Playback embeds: updates now playing
src/MusicPlayer.js - Music player → Local audio cache: caches downloads
README.md - Playback embeds → Language manager: gets translations
src/MusicEmbedManager.js - Lyrics manager → Genius lyrics: searches lyrics
src/LyricsManager.js - Lyrics manager → LRCLIB lyrics: fallback search
src/LyricsManager.js - Lyrics manager → Bot configuration: reads credentials
src/LyricsManager.js - Language manager → Guild language JSON: reads and writes
src/LanguageManager.js - Player state → Player state JSON: reads and writes
src/PlayerStateManager.js - Error handler → Language manager: gets translations
src/ErrorHandler.js - Bot bootstrap → Discord: connects bot
index.js - Bot bootstrap → Bot configuration: reads settings
index.js