A private Discord music bot (my first) built as a hobby project for learning purposes and use among friends in private Discord servers.
This project is intended for PRIVATE, NON-COMMERCIAL use only as a learning exercise.
- This bot streams audio from YouTube, which may violate YouTube's Terms of Service
- This code is shared for educational purposes and private use among friends
- I am NOT responsible for any legal consequences if you choose to use this code
- DO NOT use this bot publicly or commercially
- Users assume all legal risks and responsibilities
- Consider using official music streaming services or APIs for any public/commercial projects
/play <url>- Play a YouTube video/skip- Skip the current song/pause- Pause the current song/resume- Resume playback/stop- Stop music and clear queue/queue- Show current queue/shuffle- Shuffle the current queue/nowplaying- Show currently playing song/ping- Test bot connectivity/help- Show availables commands/about- Show information about this bot
- Node.js 18+
- Discord Bot Token & Application Credentials
- FFMPEG
- Clone this repository
- Install dependencies:
npm install
- Create a
.envfile with your Discord bot token:DISCORD_TOKEN= CLIENT_ID= GUILD_ID= - Build the project:
npm run build
- Start the bot:
npm run start
npm run build- Build the project using Rollupnpm run start- Start the built bot
- Discord.js - Discord API wrapper
- @discordjs/voice - Voice connection handling
- ytdl-core - YouTube audio streaming
- TypeScript - Type-safe JavaScript
- FFmpeg - Audio processing
This is a personal learning project. Feel free to fork and modify for your own private use, but please respect the legal disclaimer above.
This project is for educational purposes only. Use at your own risk and responsibility.
Remember: This bot is for private use among friends only. Respect YouTube's Terms of Service and applicable laws in your jurisdiction.