Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎢 Discord Music Bot

A fully-featured Discord music bot written in Python, powered by discord.py, yt-dlp, and FFmpeg.
Stream YouTube audio into voice channels, search songs, manage queues β€” and deploy it anywhere via Docker. 🐳


✨ Features

  • 🎧 Join & leave voice channels
  • πŸ” !search to find YouTube music via keywords or Spotify links (converted to YouTube)
  • ▢️ !play to queue and stream songs
  • ⏸ !pause, ⏯ !resume, !skip, !prev ❌ !leave commands
  • πŸ“„ !queue to show current and upcoming tracks
  • βœ… Auto disconnect when alone
  • 🐳 Easy deployment with Docker
Command Aliases Description
!join !j, !ahoy Bot joins your voice channel
!play !p, !Play Plays a song from queue or resumes paused playback
!search !s, !sr Search YouTube and select from a result dropdown
!pause !ps, !stop Pause current playback
!resume !res, !r Resume paused playback
!queue !q, !list Show currently playing and queued songs
!skip !next, !n Skip the current song and play the next one in queue
!prev !back, !b Go back to the previous song (if available)
!leave !l, !byebye Disconnect the bot from the voice channel

πŸ“¦ Requirements


🧰 Installation (Local Dev)

git clone https://github.com/AlexanderWeismannn/Py-Music-Bot.git
cd music-bot
pip install -r requirements.txt

🐳 Docker Deployment

You can run this music bot instantly using Docker β€” no Python or dependencies required.

  1. Download the Docker image

  2. Load the image into Docker:

    docker load -i music-bot.tar
    
  3. **Run the Bot with Discord Token

docker run -d --name musicbot -e DISCORD_BOT_TOKEN=your_token_here music-bot

About

A fully-featured Discord music bot written in Python, powered by `discord.py`, `yt-dlp`, and `FFmpeg`. Stream YouTube audio into voice channels, search songs, manage queues β€” and deploy it anywhere via Docker. 🐳

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages