EvoBot is a Discord Music Bot built with discord.js & uses Command Handler from discordjs.guide
- Discord Bot Token Guide
- YouTube Data API v3 Key Guide
2.1 (Optional) Soundcloud Client ID Guide - Node.js v14.0.0 or newer
git clone https://github.com/eritislami/evobot.git
cd evobot
npm install
After installation finishes follow configuration instructions then run node index.js
to start the bot.
Copy or Rename config.json.example
to config.json
and fill out the values:
{
"TOKEN": "",
"YOUTUBE_API_KEY": "",
"SOUNDCLOUD_CLIENT_ID": "",
"MAX_PLAYLIST_SIZE": 10,
"PREFIX": "/",
"PRUNING": false,
"LOCALE": "en",
"DEFAULT_VOLUME": 100,
"STAY_TIME": 30
}
For those who would prefer to use our Docker container, you may provide values from config.json
as environment variables.
docker run -e "TOKEN=<discord-token>" -e "YOUTUBE_API_KEY=<youtube-key>" eritislami/evobot
Note: The default prefix is '/'
- 🎶 Play music from YouTube via url
/play https://www.youtube.com/watch?v=GLvohMXgcBo
- 🔎 Play music from YouTube via search query
/play under the bridge red hot chili peppers
- 🎶 Play music from Soundcloud via url
/play https://soundcloud.com/blackhorsebrigade/pearl-jam-alive
- 🔎 Search and select music to play
/search Pearl Jam
Reply with song number or numbers seperated by comma that you wish to play
Examples: 1
or 1,2,3
- 📃 Play youtube playlists via url
/playlist https://www.youtube.com/watch?v=YlUKcNNmywk&list=PL5RNCwK3GIO13SR_o57bGJCEmqFAwq82c
- 🔎 Play youtube playlists via search query
/playlist linkin park meteora
- Now Playing (/np)
- Queue system (/queue, /q)
- Loop / Repeat (/loop)
- Shuffle (/shuffle)
- Volume control (/volume, /v)
- Lyrics (/lyrics, /ly)
- Pause (/pause)
- Resume (/resume, /r)
- Skip (/skip, /s)
- Skip to song # in queue (/skipto, /st)
- Move a song in the queue (/move, /mv)
- Remove song # from queue (/remove, /rm)
- Play an mp3 clip (/clip song.mp3) (put the file in sounds folder)
- List all clips (/clips)
- Show ping to Discord API (/ping)
- Show bot uptime (/uptime)
- Toggle pruning of bot messages (/pruning)
- Help (/help, /h)
- Command Handler from discordjs.guide
- Media Controls via Reactions
Currently available locales are:
- English (en)
- Arabic (ar)
- Brazilian Portuguese (pt_br)
- Dutch (nl)
- French (fr)
- German (de)
- Greek (el)
- Indonesian (id)
- Italian (it)
- Japanese (ja)
- Korean (ko)
- Minionese (mi)
- Persian (fa)
- Polish (pl)
- Russian (ru)
- Simplified Chinese (zh_cn)
- Singaporean Mandarin (zh_sg)
- Spanish (es)
- Swedish (sv)
- Traditional Chinese (zh_tw)
- Thai (th)
- Turkish (tr)
- Ukrainian (uk)
- Vietnamese (vi)
- Check Contributing if you wish to help add more languages!
- For languages please use ISO 639-1 two letter format
- Fork the repository
- Clone your fork:
git clone https://github.com/your-username/evobot.git
- Create your feature branch:
git checkout -b my-new-feature
- Stage changes
git add .
- Commit your changes:
cz
ORnpm run commit
do not usegit commit
- Push to the branch:
git push origin my-new-feature
- Submit a pull request
@iCrawl For the queue system used in this application which was adapted from @iCrawl/discord-music-bot