Play music from YouTube, Spotify, direct links, and livestreams with high-quality audio.
Use Harmonica on multiple Discord servers simultaneously with separate queues.
Automatically skip sponsor segments, intros, outros, and other non-music content.
Pause, skip, loop, shuffle, and manage your queue with simple commands.
Intelligent local caching system for faster playback and reduced bandwidth usage.
Get lyrics for the currently playing song with Genius integration.
Play audio from URL or search
Search YouTube for a song
Pause playback
Resume playback
Stop and clear queue
Skip current track
Replay current track
Searches for a random song
Toggle loop mode (optional count)
Show current track info
Show queue
Clear entire queue
Remove specific track
Shuffle queue
Join your channel
Leave channel
Get lyrics for current song
Manage aliases
Show bot status
Show bot version
Change command prefix
Show all commands
Clear logs (Owner)
Restart bot (Owner)
Update the bot to the latest version
View the bot's logs
Clear the bot's cache
Install Python 3.8 or higher and verify installation with python --version
Run pip install -r requirements.txt to install all required packages
Rename .env.example to .env and add your Discord token
Run python bot.py to start the bot
Rename .spotifyenv.example to .spotifyenv and add your Spotify API credentials
Edit .geniuslyrics file (created on first startup) and add your Genius API credentials
Windows: Relaunch after first install
macOS/Linux: Automatic installation
Check and update your cookies.txt file
Install Get Cookies.txt extension and export cookies to the bot's root directory