search

MCbabel / discord-music-bot

🎶 A powerful, feature-rich Discord Music Bot built with Python and discord.py, allowing seamless integration with YouTube and Spotify. Created with the assistance of ChatGPT to demonstrate the capabilities of AI-driven development.
Other
2 stars 0 forks source link
ai-development automation automation-tool bot-commands collaboration community-project discord-api discord-bot discord-integration discord-py ffmpeg github-actions lyrics music-bot open-source project python spotify spotipy youtube

readme

🎶 Discord Music Bot

Welcome to the Discord Music Bot repository! This bot is a powerful, feature-rich music bot built with Python and discord.py, offering seamless integration with YouTube and Spotify. This project was created with the assistance of ChatGPT to demonstrate the capabilities of AI-driven development.

Table of Contents

  1. Features
  2. Commands
  3. Installation
  4. Getting Spotify Credentials
  5. Getting Genius API Key
  6. Discord Bot Permissions
  7. Contributing
  8. License
  9. Acknowledgements
  10. Planned Features

Features

Commands

Command Description
/join Join your voice channel.
/leave Leave the voice channel.
/play <URL> Play a YouTube or Spotify track.
/pause Pause the playback.
/resume Resume the playback.
/skip Skip the current song.
/stop Stop the playback and clear the queue.
/lyrics Fetch the lyrics for the current song.
/help Show help information.
/volume <percent> Set the playback volume (0-100%).
/loop <on/off> Enable or disable looping of the current song.
/add_to_playlist <name> <url> Add a song to a custom playlist.
/play_playlist <name> Play songs from a custom playlist.
/vote_skip Vote to skip the current song.
/clear <number> Clear a number of messages in a channel (admin only).
/list_playlists List all custom playlists and their creators.

Installation

You have two options to set up the Discord Music Bot: cloning the repository or using the provided setup installer.

Option 1: Clone the repository

  1. Clone the repository:

    git clone https://github.com/MCbabel/discord-music-bot.git
cd discord-music-bot

  2. Install the required dependencies:

    pip install -r requirements.txt

  3. Set up your environment variables:

    Create a .env file in the root directory and add your Discord token, Spotify credentials, and Genius API key:

    DISCORD_TOKEN=your_discord_token
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
GENIUS_ACCESS_TOKEN=your_genius_api_key

  4. Run the bot:

    python bot.py

Option 2: Use the setup installer

  1. Download the setup file:

  2. Run the setup file:

    Double-click on the setup.bat file and follow the prompts to enter your Discord Bot Token, Spotify Client ID, Spotify Client Secret, and Genius API Key. This will automatically set up your environment variables and install the required dependencies.

  3. Run the bot:

    Once the setup is complete, simply run the bot.py file to start the bot.

    python bot.py

Getting Spotify Credentials

To integrate Spotify, you need to obtain a Client ID and Client Secret from the Spotify Developer Dashboard. Here are the steps:

  1. Create a Spotify Developer Account:

  2. Create an App:

    • Click on "Create an App".
    • Fill in the required details like App name and description.
    • Agree to the terms and conditions and click "Create".

  3. Retrieve Your Credentials:

    • Once your app is created, you will be redirected to the app dashboard.
    • Here, you can find your Client ID and Client Secret. Copy these values.

  4. Add Credentials to .env File:

    • Update your .env file with the obtained credentials.
    DISCORD_TOKEN=your_discord_token
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
GENIUS_ACCESS_TOKEN=your_genius_api_key

Getting Genius API Key

To fetch lyrics, you need to obtain a Genius API Key. Here are the steps:

  1. Create a Genius Account:

    • Go to the Genius API Clients page.
    • Log in with your Genius account or create a new account.

    Genius API Account

  2. Create an API Client:

    • Click on "Create an API Client".
    • Fill in the required details like App name and description.
    • Agree to the terms and conditions and click "Save".

    Create API Client

  3. Retrieve Your API Key:

    • Once your app is created, you will be redirected to the app dashboard.
    • Here, you can find your Client Access Token. Copy this value.

    Retrieve API Key

  4. Add API Key to .env File:

    • Update your .env file with the obtained API Key.
    DISCORD_TOKEN=your_discord_token
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
GENIUS_ACCESS_TOKEN=your_genius_api_key

Discord Bot Permissions

To ensure that your bot works correctly, you need to invite it to your server with the necessary permissions. Use the following OAuth2 URL to generate an invite link for your bot:

https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=277083450752&scope=bot%20applications.commands

Replace YOUR_CLIENT_ID with your bot's client ID, which you can find in the Discord Developer Portal.

Required Permissions

Contributing

Contributions are welcome! Please fork this repository and submit a pull request for any changes you would like to make.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgements

This project was created with the assistance of ChatGPT, demonstrating the power of AI in software development. Special thanks to the OpenAI team for providing such an incredible tool.

Planned Features

Happy listening! 🎵