Skip to content

coslynx/discord-music-experience-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


discord-music-experience-bot

An immersive Discord bot for music playback and community engagement.

Developed with the software and tools below.

git-last-commit GitHub commit activity GitHub top language

📑 Table of Contents

  • 📍 Overview
  • 📦 Features
  • 📂 Structure
  • 💻 Installation
  • 🏗️ Usage
  • 🌐 Hosting
  • 📜 License
  • 👥 Authors

📍 Overview

The repository contains a project called "discord-music-experience-bot" that provides a comprehensive solution to enhance social interaction through shared music experiences in Discord voice channels.

📦 Features

Feature Description
🎶 Play Music Play songs from various platforms like YouTube, Spotify, and SoundCloud in voice channels.
📻 Queue Management Users can add, remove, or reorder songs in the music queue dynamically.
🔊 Volume Control Adjust playback volume to suit the ambiance of the server.
User Commands Easy-to-use commands like !play, !skip, !stop, and !pause for intuitive interactions.
🔍 Song Search Effortlessly search for songs by keywords, genres, or artists with autocomplete suggestions.
ℹ️ Playback Information Display current track details including title, artist, and duration, along with the playlist.
📜 Custom Playlists Create and share personal playlists, enhancing community sharing.
🔄 Cross-Server Functionality Switch between different voice channels while maintaining playback seamlessly.
🔒 Moderation Controls Enable server admins to regulate bot functionality, ensuring compliance with community standards.

📂 Structure

discord-music-experience-bot/
│
├── commands/
│   ├── play.js
│   ├── skip.js
│   ├── stop.js
│   ├── pause.js
│   ├── volume.js
│   ├── queue.js
│   ├── search.js
│   ├── playlist.js
│   └── help.js
│
├── events/
│   ├── message.js
│   ├── guildMemberAdd.js
│   └── ready.js
│
├── services/
│   ├── musicService.js
│   ├── queueService.js
│   ├── userService.js
│   └── playlistService.js
│
├── models/
│   ├── userModel.js
│   ├── playlistModel.js
│   └── songModel.js
│
├── utils/
│   ├── commandHandler.js
│   ├── logger.js
│   └── errorHandler.js
│
├── config/
│   ├── env.config.js
│   └── database.config.js
│
├── routes/
│   ├── api.js
│   └── musicRoutes.js
│
├── middleware/
│   ├── authentication.js
│   ├── permissions.js
│   └── logging.js
│
├── .env
├── package.json
└── README.md

💻 Installation

🔧 Prerequisites

  • Node.js
  • npm
  • MongoDB

🚀 Setup Instructions

  1. Clone the repository:
    git clone https://github.com/spectra-ai-codegen/discord-music-experience-bot.git
  2. Navigate to the project directory:
    cd discord-music-experience-bot
  3. Install dependencies:
    npm install

🏗️ Usage

🏃‍♂️ Running the Project

  1. Start the bot:
    npm start
  2. Invite the bot to your server and enjoy sharing music with your community!

⚙️ Configuration

Adjust configuration settings in .env to set up database connections and API keys.

🌐 Hosting

🚀 Deployment Instructions

You can host your bot on cloud platforms such as Heroku, AWS, or DigitalOcean.

  1. Install the Heroku CLI:
    npm install -g heroku
  2. Login to Heroku:
    heroku login
  3. Create a new Heroku app:
    heroku create
  4. Deploy the code:
    git push heroku main

🔑 Environment Variables

  • DB_HOST: Database host
  • DB_USER: Database user
  • DB_PASS: Database password

📜 License

This project is licensed under the GNU AGPLv3.

👥 Authors

🌐 Spectra.Codes

Why only generate Code? When you can generate the whole Repository!