Discord Music Bot in Rust 🎵

A simple yet functional Discord bot written in Rust that can play music from YouTube in voice channels. Built using the Serenity and Songbird libraries.

Features ✨

• Join voice channels (!join)
• Play music from YouTube URLs (!play)
• Leave voice channel (!leave)
• Automatic volume control
• Status messages with emojis
• Robust error handling

Prerequisites 📋

Before running the bot, make sure you have the following installed:

• Rust
• yt-dlp
• FFmpeg

macOS

# Using Homebrew
brew install rust
brew install yt-dlp
brew install ffmpeg

Linux (Ubuntu/Debian)

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Install yt-dlp and ffmpeg
sudo apt update
sudo apt install yt-dlp ffmpeg

Setup 🔧

1. Create a new application in the Discord Developer Portal
2. Create a bot for your application and copy the token
3. Replace "PLACE_YOUR_TOKEN_HERE" in src/main.rs with your token
4. Invite the bot to your server using the OAuth2 URL generated in the portal

Installation 🚀

# Clone the repository
git clone [email protected]:louire/discord_plays.git
cd discord_plays

# Build and run
cargo run

Usage 📖

Once the bot is online, you can use the following commands:

• !join - Bot joins your current voice channel
• !play <url> - Plays audio from a YouTube video
• !leave - Bot leaves the voice channel

Example:

!play https://www.youtube.com/watch?v=dQw4w9WgXcQ

Troubleshooting 🔍

If you encounter issues:

1. Verify all dependencies are installed:

yt-dlp --version
ffmpeg -version

2. Ensure the bot has the necessary Discord permissions:

   • Connect (to voice channels)
   • Speak
   • Send Messages

3. Check that the YouTube URL is valid and accessible

4. Review console logs for error messages

TODO List 📝

Features and improvements we plan to add:

High Priority

• Search functionality: Allow users to search songs by name instead of requiring the exact URL
• Track selection: Show top 5 results when searching and let users choose
• Queue system: Add ability to queue multiple songs
• Skip command: Add ability to skip current track
• Volume control: Add command to adjust volume during playback

Medium Priority

• Playlist support: Allow playing entire YouTube playlists
• Save favorites: Let users save their favorite songs
• Song info display: Show current song title, duration, and progress
• Error recovery: Auto-reconnect on disconnection
• Permissions system: Add DJ role and admin commands

Contributing 🤝

Contributions are welcome! Here's how you can help:

1. Pick an item from the TODO list
2. Open an issue to discuss your implementation
3. Fork the repository
4. Create a new branch for your feature
5. Submit a pull request

Please ensure your code:

• Follows the existing code style
• Includes appropriate comments
• Has been tested thoroughly
• Updates the README if adding new commands

License 📄

This project is licensed under the MIT License - see the LICENSE.md file for details.

Acknowledgments 👏

• Serenity - Discord framework for Rust
• Songbird - Voice library for Serenity
• yt-dlp - YouTube downloader