Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/coslynx/project-1722833603841-x66u2b
Project: Discord Music Bot: Play Your Favorite Tunes. Created at https://spectra.codes, which is owned by @Drix10
https://github.com/coslynx/project-1722833603841-x66u2b
audio-streaming code-generation code-quality command-system developer-tools devops discord-bot discord-py ffmpeg machine-learning music-bot music-player music-queue python redis software-development soundcloud-api spotify-api voice-channel-integration youtube-dl
Last synced: 2 days ago
JSON representation
Project: Discord Music Bot: Play Your Favorite Tunes. Created at https://spectra.codes, which is owned by @Drix10
- Host: GitHub
- URL: https://github.com/coslynx/project-1722833603841-x66u2b
- Owner: coslynx
- Created: 2024-08-05T04:53:24.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-08-05T04:54:09.000Z (about 2 months ago)
- Last Synced: 2024-09-20T12:29:22.858Z (7 days ago)
- Topics: audio-streaming, code-generation, code-quality, command-system, developer-tools, devops, discord-bot, discord-py, ffmpeg, machine-learning, music-bot, music-player, music-queue, python, redis, software-development, soundcloud-api, spotify-api, voice-channel-integration, youtube-dl
- Language: JavaScript
- Size: 5.86 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
project-1722833603841-x66u2b
A Discord music bot built with Python and Discord.py for seamless music playback experience on servers.
Developed with the software and tools below.
## 📑 Table of Contents
- 📍 Overview
- 📦 Features
- 📂 Structure
- 💻 Installation
- 🏗️ Usage
- 🌐 Hosting
- 📄 License
- 👏 Authors
## 📍 Overview
This repository houses a Discord music bot project built to enhance user engagement within Discord communities. The bot provides a user-friendly interface for music playback, offering a robust and interactive experience.
## 📦 Features
This Discord music bot boasts a range of features designed for seamless and enjoyable music listening experiences on Discord servers:
| Feature | Description |
|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------|
| Music Playback | Play music from various sources like YouTube, Spotify, and SoundCloud. |
| Queue Management | Manage a music queue: add, remove, reorder, shuffle, and loop songs. |
| Playback Controls | Control music playback: play, pause, resume, skip, and stop. |
| Voice Channel Integration | Join and leave voice channels to play music directly within your Discord community. |
| User Interface | Intuitive command system with clear prompts and informative responses for easy interaction. |
| Now Playing Information | Display information about the currently playing song. |
| Search Functionality | Search for music from different sources. |
| Advanced Queue Management | Utilize a robust queue management system to view, skip, loop, and manage queue priority. |
| User-Specific Settings | Customize your experience with volume control, preferred sources, and custom commands. |
| Web-based Interface | (Optional) Develop a web interface for managing settings, configuring playlists, and monitoring activity. |
| Radio Mode | (Optional) Implement a radio mode for playing continuous streams from various sources. |
## 📂 Structure
```
└── bot
├── commands
│ ├── music.js
│ ├── admin.js
│ ├── help.js
│ ├── info.js
│ ├── join.js
│ ├── leave.js
│ ├── play.js
│ ├── pause.js
│ ├── resume.js
│ ├── skip.js
│ ├── stop.js
│ ├── queue.js
│ ├── shuffle.js
│ ├── loop.js
│ ├── volume.js
│ └── nowplaying.js
├── events
│ ├── ready.js
│ ├── messageCreate.js
│ ├── voiceStateUpdate.js
│ └── interactionCreate.js
├── services
│ ├── musicService.js
│ ├── queueService.js
│ ├── playlistService.js
│ └── youtubeService.js
├── utils
│ ├── commandHandler.js
│ ├── logger.js
│ └── errorHandler.js
└── config
├── env.config.js
└── config.js
```
## 💻 Installation
### 🔧 Prerequisites
- Python 3.7 or higher
- pip (Python package installer)
- Discord Bot Token (Obtain one from the Discord Developer Portal: https://discord.com/developers/applications)
### 🚀 Setup Instructions
1. Clone the repository:
- `git clone https://github.com/spectra-ai-codegen/project-1722833603841-x66u2b.git`
2. Navigate to the project directory:
- `cd project-1722833603841-x66u2b`
3. Install dependencies:
- `pip install -r requirements.txt`
4. Create a `.env` file in the root directory and add your Discord Bot Token:
- `DISCORD_TOKEN=`
5. Run the bot:
- `python bot/main.js`
## 🏗️ Usage
1. Invite the bot to your Discord server:
- Go to the Discord Developer Portal and create a bot application.
- Obtain the bot's OAuth2 URL (with the "bot" scope) from the Developer Portal.
- Use the URL to invite the bot to your server.
2. Use the following commands within a voice channel:
- `!play `: Plays a song from a supported music service.
- `!pause`: Pauses the currently playing song.
- `!resume`: Resumes playback after pausing.
- `!skip`: Skips the current song.
- `!stop`: Stops playback and clears the queue.
- `!queue`: Shows the current music queue.
- `!queue add `: Adds a song to the queue.
- `!queue remove `: Removes a song from the queue.
- `!shuffle`: Randomizes the order of songs in the queue.
- `!loop`: Toggles looping the current song or the entire queue.
- `!volume `: Adjusts the playback volume.
- `!info`: Displays information about the currently playing song.
- `!join `: Makes the bot join the specified voice channel.
- `!leave`: Makes the bot leave the current voice channel.
## 🌐 Hosting
### 🚀 Deployment Instructions
1. Install Docker:
- Follow instructions for your operating system: https://docs.docker.com/get-docker/
2. Build a Docker Image:
- `docker build -t discord-music-bot .`
3. Run the Docker Container:
- `docker run -d -p 8080:8080 discord-music-bot`
- Replace `8080` with a different port if necessary.
## 📄 License
This project is licensed under the [MIT License](https://choosealicense.com/licenses/mit/).
## 👏 Authors
- Drix10 - [Spectra.codes](https://spectra.codes) - [GitHub](https://github.com/Drix10)
🌐 Spectra.Codes
Why only generate Code? When you can generate the whole Repository!
