{"id":15478262,"url":"https://github.com/mytja/harmonoid-music-bot","last_synced_at":"2025-04-22T14:45:14.721Z","repository":{"id":51121547,"uuid":"332179548","full_name":"mytja/harmonoid-music-bot","owner":"mytja","description":"🎵 Music bot for Discord. Supports lyrics, queues \u0026 plays using both YT Music \u0026 YouTube.","archived":false,"fork":false,"pushed_at":"2024-10-14T19:20:36.000Z","size":598,"stargazers_count":13,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-19T03:20:30.883Z","etag":null,"topics":["bot","discord","discord-bot","discord-music","discord-py","music"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mytja.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2021-01-23T10:08:18.000Z","updated_at":"2024-10-14T19:20:40.000Z","dependencies_parsed_at":"2023-02-18T10:17:22.151Z","dependency_job_id":"46f26acc-a189-412a-8771-b14aae1d9e87","html_url":"https://github.com/mytja/harmonoid-music-bot","commit_stats":{"total_commits":169,"total_committers":6,"mean_commits":"28.166666666666668","dds":0.6923076923076923,"last_synced_commit":"1ccb02e224f35fde0672408b16547ebcce563140"},"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mytja%2Fharmonoid-music-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mytja%2Fharmonoid-music-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mytja%2Fharmonoid-music-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mytja%2Fharmonoid-music-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mytja","download_url":"https://codeload.github.com/mytja/harmonoid-music-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250262280,"owners_count":21401653,"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":["bot","discord","discord-bot","discord-music","discord-py","music"],"created_at":"2024-10-02T04:03:03.900Z","updated_at":"2025-04-22T14:45:14.688Z","avatar_url":"https://github.com/mytja.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- bump3 --\u003e\n\n\u003ch1 align='center'\u003e\u003ca href='https://github.com/harmonoid/harmonoid-music-bot'\u003eHarmonoid Music Bot\u003c/a\u003e\u003c/h1\u003e\n\u003ch4 align='center'\u003e🎵 Music bot for Discord. Supports lyrics, queues \u0026 plays using both YT Music \u0026 YouTube.\u003c/h4\u003e\n\u003cp align='center'\u003e\u003ca href='https://harmonoid.github.io/harmonoid-music-bot'\u003eWebsite\u003c/a\u003e\u003c/p\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src='https://github.com/harmonoid/harmonoid-music-bot/blob/screenshots/1.PNG?raw=true'\u003e\u003c/img\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src='https://github.com/harmonoid/harmonoid-music-bot/blob/screenshots/2.PNG?raw=true'\u003e\u003c/img\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src='https://github.com/harmonoid/harmonoid-music-bot/blob/screenshots/3.PNG?raw=true'\u003e\u003c/img\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## 💜 Support\n\nYou may open a issue, and we will be happy to assist.\n\n## 🎵 Invite\n\nYou have to self-deploy it - instructions down bellow.\n\n## 🎹 Commands\n\n### 🎵 Playback Commands\n\n| Command                     | Aliases  | Action                                                                                    |\n|-----------------------------|----------|-------------------------------------------------------------------------------------------|\n| -play   \u003csong name or link\u003e | -p       | Plays or adds a track to queue from YouTube Music.                                        |\n| -playYT \u003csong name or link\u003e | -py      | Plays or adds a track to queue from YouTube.                                              |\n| -pause                      |          | Pauses playback.                                                                          |\n| -resume                     |          | Resumes playback.                                                                         |\n| -togglePlayback             | -pp      | Switches between pause \u0026 play states.                                                     |\n\n### 📑 Queue Commands\n\n| Command                 | Aliases  | Action                                                                                    |\n|-------------------------|----------|-------------------------------------------------------------------------------------------|\n| -queue                  | -q       | Displays the current queue.                                                               |\n| -next                   | -n       | Jumps to next track in the queue.                                                         |\n| -back                   | -b       | Jumps to previous track in the queue.                                                     |\n| -jump   \u003cposition\u003e      | -j       | Jumps to specific track in the queue based on its position.                               |\n| -delete \u003cposition\u003e      | -d       | Removes track from the queue from the given position.                                     |\n| -clear                  | -c       | Clears the queue.                                                                         |\n  \n### 🧰 Utility Commands\n\n| Command                             | Aliases  | Action                                                                                    |\n|-------------------------------------|----------|-------------------------------------------------------------------------------------------|\n| -lyrics     \u003csong name\u003e             | -l       | Shows lyrics of a track.                                                                  |\n| -lyricsSend \u003csong name\u003e             | -ls      | Sends lyrics of a track in a TXT file.                                                    |\n| -changeChannel \u003cvoice channel name\u003e | -cc      | Changes voice channel where music should be played.                                       |\n\n### 📖 Other Commands\n\n| Command                             | Aliases  | Action                                                                                    |\n|-------------------------------------|----------|-------------------------------------------------------------------------------------------|\n| -status                             | -s       | Displays bot's statistics.                                                                |\n| -about                              | -a       | Displays information about bot.                                                           |\n\n## 🔐 Deploy Personally\n\nYou can deploy this bot on Heroku or on a self hosted machine.\n\n### Personal deployment\nDocker is recommended for personal deployment.\n\n#### Docker (self-hosted machine)\nIf you have Docker installed, you can enter following commands:\n```bash\nsudo docker pull ghcr.io/mytja/harmonoid-music-bot:latest\nsudo docker run -d -e DISCORD_TOKEN=\u003cyour discord bot token\u003e ghcr.io/mytja/harmonoid-music-bot\n```\nYou can view your running machines using `sudo docker ps`\n\nAfterwards, you can see logs using `sudo docker logs \u003cyour docker container id\u003e`.\nDocker container ID can be obtained using `sudo docker ps`\n\n#### Self-deploy on Ubuntu/Debian based distros\n1. Get repository `git clone https://github.com/mytja/harmonoid-music-bot`\n2. Change directory `cd harmonoid-music-bot`\n3. Install Python dependencies `python3 -m pip install -r requirements.txt`\n4. Install ffmpeg `sudo apt install ffmpeg`\n5. Export environment variable `export DISCORD_TOKEN=\u003cyour discord bot token\u003e`\n6. Run a program `python3 main.py`\n\n### Deploying to Heroku\n- Create an account on Heroku if you don't have it yet\n- Create an app\n- Create a fork of our repo on GitHub \u0026 Deploy it on Heroku\n- Get a Discord Bot Token from Discord\n- Add a secret key called DISCORD_TOKEN with value of a discord token, you got earlier, to Heroku app\n- Flip a toggle switch on main page of your app\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)\n\n## ⭐ Acknowledgements\n- [sigmatics](https://github.com/sigma67) for [ytmusicapi](https://github.com/sigma67/ytmusicapi)\n- [PyTube](https://github.com/pytube) for [PyTube](https://github.com/pytube/pytube)\n- [Tin Tvrtković](https://github.com/Tinche) for [aiofiles](https://github.com/Tinche/aiofiles)\n- [alexmercerind](https://github.com/alexmercerind) for [youtube-search-python](https://github.com/alexmercerind/youtube-search-python)\n- [Danny](https://github.com/Rapptz) for [discord.py](https://github.com/Rapptz/discord.py)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmytja%2Fharmonoid-music-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmytja%2Fharmonoid-music-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmytja%2Fharmonoid-music-bot/lists"}