🎵 The Most Advanced Discord Music Bot on GitHub - High-quality music playback, seamless performance, and feature-rich entertainment for your Discord server.
Looking for the best Discord music bot on GitHub? GhoSty offers superior audio quality, reliable performance, and an extensive feature set that stands out from other Discord music bots. Built with Discord.py and Wavelink, this bot delivers professional-grade music experience with minimal setup.
- Multi-Source Support: Play music from YouTube, SoundCloud, and more
- High-Quality Audio: Crystal clear 128kbps to 384kbps audio quality
- Smart Queue System: Intelligent queue management with persistent playback
- Seamless Looping: Track, queue, and auto-play loop modes
- Volume Control: Precise volume adjustment from 1% to 150%
- Bass Boost: Enhance low frequencies for powerful bass
- Nightcore: Speed up tracks for energetic listening
- 8D Audio: Immersive 8D surround sound experience
- Vaporwave: Slow down tracks for chill vibes
- Custom Filters: Create your own audio presets
- 24/7 Radio: Continuous music playback without interruptions
- Multiple Genres: Pop, Rock, Electronic, Hip-Hop, and more
- Custom Stations: Add your own radio stream URLs
- Auto-Resume: Never miss a beat with automatic reconnection
- Low Latency: Optimized for smooth playback
- Error Handling: Comprehensive error management with user-friendly messages
- Auto-Reconnect: Automatic recovery from connection issues
- Resource Efficient: Minimal CPU and memory usage
- Python 3.10 or higher
- FFmpeg installed
- Discord Bot Token
- Lavalink server (can use free nodes)
-
Clone the Repository
git clone https://github.com/WannaBeGhoSt/GhoSty-Discord-Music-Bot.git cd GhoSty-Discord-Music-Bot -
Install Dependencies
pip install -r requirements.txt
-
Configure Your Bot
# Update config.py with your details BOT_TOKEN = "your-discord-bot-token" PREFIX = "?" # Your preferred prefix
-
Run the Bot
python ghosty.py
docker build -t ghosty-music-bot .
docker run -d --name ghosty-bot ghosty-music-bot| Command | Description | Example |
|---|---|---|
?play <query> |
Play song/playlist from YouTube/SoundCloud | ?play imagine dragons believer |
?pause |
Pause current track | ?pause |
?resume |
Resume playback | ?resume |
?skip |
Skip to next track | ?skip |
?stop |
Stop playback and clear queue | ?stop |
?queue |
Show current queue | ?queue |
?nowplaying |
Show currently playing track | ?np |
?volume <1-150> |
Adjust volume (1-150%) | ?volume 80 |
?loop [track/queue/off] |
Set loop mode | ?loop queue |
| Command | Description | Example |
|---|---|---|
?bassboost |
Enhance bass frequencies | ?bassboost |
?nightcore |
Apply nightcore effect | ?nightcore |
?8d |
Enable 8D audio effect | ?8d |
?vaporwave |
Apply vaporwave effect | ?vaporwave |
?reset |
Reset all audio filters | ?reset |
| Command | Description | Example |
|---|---|---|
?radio <station> |
Play radio station | ?radio pop |
?radio list |
List available stations | ?radio list |
?radio add <name> <url> |
Add custom station | ?radio add mystation https://... |
For optimal performance, we recommend setting up your own Lavalink server:
-
Download Lavalink
wget https://github.com/lavalink-devs/Lavalink/releases/latest/download/Lavalink.jar
-
Configure application.yml
server: port: 2333 lavalink: server: password: "your-password-here"
-
Run Lavalink
java -jar Lavalink.jar
- Modify
config.pyfor custom settings - Edit
embeds.pyto customize message appearances - Adjust
audio_filters.pyfor custom audio effects
GhoSty combines advanced features, reliable performance, and easy setup. Unlike other Discord music bots, it offers professional audio quality, extensive customization, and regular updates.
- Bot not joining voice channel: Check voice permissions
- No sound: Ensure FFmpeg is installed correctly
- Playback errors: Verify Lavalink node connection
Yes! GhoSty supports multiple servers simultaneously with separate queues for each.
Edit the radio_stations.json file or use the ?radio add command to add custom stations.
- Startup Time: < 2 seconds
- Command Response: < 100ms
- Audio Latency: < 500ms
- Memory Usage: ~50MB (idle), ~150MB (playing)
- CPU Usage: < 5% average
We welcome contributions! Here's how you can help:
- Fork the repository
- Create a feature branch:
git checkout -b feature/AmazingFeature - Commit your changes:
git commit -m 'Add AmazingFeature' - Push to the branch:
git push origin feature/AmazingFeature - Open a pull request
# Install development dependencies
pip install -r requirements-dev.txt
# Run tests
python -m pytest tests/
# Code formatting
black .Need help? Join our active Discord community for support, updates, and suggestions:
- Report Bugs: GitHub Issues
- Request Features: Feature Requests
- Get Help: Discord Support
This project is licensed under the MIT License - see the LICENSE file for details.
- Discord.py team for the excellent library
- Wavelink for reliable Lavalink integration
- FFmpeg for audio processing capabilities
- Our contributors and community members
⭐ Star this repository if you found it helpful! This helps the project gain visibility and helps others discover the best Discord music bot on GitHub.
📢 Share with friends who are looking for a reliable, feature-rich Discord music bot solution.
🐛 Found a bug? Open an issue on GitHub and we'll fix it promptly!
Tags: discord music bot, discord.py bot, wavelink bot, python discord bot, music bot github, best discord music bot, free music bot, discord bot with radio, high quality music bot, discord.py music example, lavalink bot, discord music python, open source discord bot