Skip to content

A self-hosted music discord bot, with detailed documentation and constantly upgrading features. Attached below is the documentation to deploy the bot. : )

License

Notifications You must be signed in to change notification settings

Yoda-Canada/chords

 
 

Repository files navigation

Banner

Logo

Chords

On a mission to build the best Discord Music Bot

View Demo · Report Bug · Request Feature . Deploy Walkthrough

Table of Contents
  1. About The Project
  2. Getting Started
  3. Bot Commands
  4. Configuration - Discord Developer Portal
  5. Roadmap
  6. Contributing
  7. License

About The Project

Most of the Discord Music Bots are down. They got banned, unfortunately.
So we thought of making our own Discord Music Bot for our Discord Community.

Built With

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

You should have Python and FFmpeg installed in your system

  • Download Python3 from here
  • Download FFmpeg from here

Installation

  1. Fork the project first

  2. Clone the forked repo

    git clone https://github.com/your_name/chords.git
  3. In the project directory, install the packages using

    pip install -r requirements.txt
  4. Create a Bot from the Discord Developer Portal and copy the Bot token. Create a .env file and paste the Token.

    TOKEN = "Your Token"
  5. Invite the Bot to your server and run

    python app.py

Configuration - Discord Developer Portal

Go to the Discord Developer Portal to create your application and bot. You must give the following permissions:

  • Server Members Intent ✔️
  • Text Permissions:
    • Send Messages ✔️
    • Read Message History ✔️

Available Bot Commands

You will currently need a discord role DJ to use all the available commands

 _p : Plays the song with search keyword following the command 
_pn : Moves the song to the top of the queue
_pause : Pause the currently playing song
_resume : Resume the currently playing song
_q : Shows the music added in list/queue
_s : Skips the currently playing music
_r : removes song from queue at index given.
_l : Commands the bot to leave the voice channel
_help : shows all the commands of the bot.

Roadmap

See the open issues for a list of proposed features (and known issues). Feel free to raise new issues.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch ( git checkout -b feature/AmazingFeature )
  3. Add your Changes ( git add . )
  4. Commit your Changes ( git commit -m 'Add some AmazingFeature' )
  5. Push to the Branch ( git push origin feature/AmazingFeature )
  6. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

About

A self-hosted music discord bot, with detailed documentation and constantly upgrading features. Attached below is the documentation to deploy the bot. : )

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%