{"id":13455473,"url":"https://github.com/eritislami/evobot","last_synced_at":"2025-05-14T14:08:01.144Z","repository":{"id":37924502,"uuid":"186841818","full_name":"eritislami/evobot","owner":"eritislami","description":"🤖 EvoBot is a Discord Music Bot built with TypeScript + Discord.js, includes Docker builds \u0026 localization in 20+ languages","archived":false,"fork":false,"pushed_at":"2024-09-05T04:46:25.000Z","size":1342,"stargazers_count":1861,"open_issues_count":18,"forks_count":2011,"subscribers_count":52,"default_branch":"master","last_synced_at":"2025-05-10T17:07:00.132Z","etag":null,"topics":["command-handler","discord","discord-bot","discord-js","discord-music-bot","discordjs","docker","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eritislami.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-15T14:19:37.000Z","updated_at":"2025-05-07T21:15:57.000Z","dependencies_parsed_at":"2023-02-12T21:35:13.274Z","dependency_job_id":"c7b9c996-0f20-4a8e-a909-b6b6e8f33c10","html_url":"https://github.com/eritislami/evobot","commit_stats":{"total_commits":572,"total_committers":82,"mean_commits":6.975609756097561,"dds":"0.48426573426573427","last_synced_commit":"d785326612165d83c06a429c1914c76db04005e6"},"previous_names":[],"tags_count":37,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eritislami%2Fevobot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eritislami%2Fevobot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eritislami%2Fevobot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eritislami%2Fevobot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eritislami","download_url":"https://codeload.github.com/eritislami/evobot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254159545,"owners_count":22024562,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["command-handler","discord","discord-bot","discord-js","discord-music-bot","discordjs","docker","typescript"],"created_at":"2024-07-31T08:01:05.900Z","updated_at":"2025-05-14T14:08:01.123Z","avatar_url":"https://github.com/eritislami.png","language":"TypeScript","readme":"![Node build](https://github.com/eritislami/evobot/actions/workflows/node.yml/badge.svg)\n![Docker build](https://github.com/eritislami/evobot/actions/workflows/docker.yml/badge.svg)\n[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)\n\n![logo](https://repository-images.githubusercontent.com/186841818/8aa95700-7730-11e9-84be-e80f28520325)\n\n# 🤖 EvoBot (Discord Music Bot)\n\n\u003e EvoBot is a Discord Music Bot built with TypeScript, discord.js \u0026 uses Command Handler from [discordjs.guide](https://discordjs.guide)\n\n## Requirements\n\n1. Discord Bot Token **[Guide](https://discordjs.guide/preparations/setting-up-a-bot-application.html#creating-your-bot)**  \n   1.1. Enable 'Message Content Intent' in Discord Developer Portal\n2. Node.js 16.11.0 or newer\n\n## 🚀 Getting Started\n\n```sh\ngit clone https://github.com/eritislami/evobot.git\ncd evobot\nnpm install\n```\n\nAfter installation finishes follow configuration instructions then run `npm run start` to start the bot.\n\n## ⚙️ Configuration\n\nCopy or Rename `config.json.example` to `config.json` and fill out the values:\n\n⚠️ **Note: Never commit or share your token or api keys publicly** ⚠️\n\n```json\n{\n  \"TOKEN\": \"\",\n  \"MAX_PLAYLIST_SIZE\": 10,\n  \"PRUNING\": false,\n  \"LOCALE\": \"en\",\n  \"DEFAULT_VOLUME\": 100,\n  \"STAY_TIME\": 30\n}\n```\n\n## 🐬 Docker Configuration\n\nFor those who would prefer to use our [Docker container](https://hub.docker.com/repository/docker/eritislami/evobot), you may provide values from `config.json` as environment variables.\n\n```shell\ndocker run -e \"TOKEN=\u003cdiscord-token\u003e\" eritislami/evobot\n```\n\n## 📝 Features \u0026 Commands\n\n- 🎶 Play music from YouTube via url\n\n`/play https://www.youtube.com/watch?v=GLvohMXgcBo`\n\n- 🔎 Play music from YouTube via search query\n\n`/play under the bridge red hot chili peppers`\n\n- 🔎 Search and select music to play\n\n`/search Pearl Jam`\n\n- 📃 Play youtube playlists via url\n\n`/playlist https://www.youtube.com/watch?v=YlUKcNNmywk\u0026list=PL5RNCwK3GIO13SR_o57bGJCEmqFAwq82c`\n\n- 🔎 Play youtube playlists via search query\n\n`/playlist linkin park meteora`\n\n- Now Playing (/nowplaying)\n- Queue system (/queue)\n- Loop / Repeat (/loop)\n- Shuffle (/shuffle)\n- Volume control (/volume)\n- Lyrics (/lyrics)\n- Pause (/pause)\n- Resume (/resume)\n- Skip (/skip)\n- Skip to song # in queue (/skipto)\n- Move a song in the queue (/move)\n- Remove song # from queue (/remove)\n- Show ping to Discord API (/ping)\n- Show bot uptime (/uptime)\n- Toggle pruning of bot messages (/pruning)\n- Help (/help)\n- Command Handler from [discordjs.guide](https://discordjs.guide/)\n- Media Controls via Buttons\n\n![buttons](https://i.imgur.com/67TGY0c.png)\n\n## 🌎 Locales\n\nCurrently available locales are:\n\n- English (en)\n- Arabic (ar)\n- Brazilian Portuguese (pt_br)\n- Bulgarian (bg)\n- Romanian (ro)\n- Czech (cs)\n- Dutch (nl)\n- French (fr)\n- German (de)\n- Greek (el)\n- Indonesian (id)\n- Italian (it)\n- Japanese (ja)\n- Korean (ko)\n- Minionese (mi)\n- Persian (fa)\n- Polish (pl)\n- Russian (ru)\n- Simplified Chinese (zh_cn)\n- Singaporean Mandarin (zh_sg)\n- Spanish (es)\n- Swedish (sv)\n- Traditional Chinese (zh_tw)\n- Thai (th)\n- Turkish (tr)\n- Ukrainian (uk)\n- Vietnamese (vi)\n- Check [Contributing](#-contributing) if you wish to help add more languages!\n- For languages please use [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) two letter format\n\n## 🤝 Contributing\n\n1. [Fork the repository](https://github.com/eritislami/evobot/fork)\n2. Clone your fork: `git clone https://github.com/your-username/evobot.git`\n3. Create your feature branch: `git checkout -b my-new-feature`\n4. Stage changes `git add .`\n5. Commit your changes: `cz` OR `npm run commit` do not use `git commit`\n6. Push to the branch: `git push origin my-new-feature`\n7. Submit a pull request\n","funding_links":[],"categories":["TypeScript","Bots"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feritislami%2Fevobot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feritislami%2Fevobot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feritislami%2Fevobot/lists"}