{"id":20720059,"url":"https://github.com/imagineeeinc/amethyst","last_synced_at":"2026-02-12T04:18:21.541Z","repository":{"id":111069860,"uuid":"491238831","full_name":"imagineeeinc/Amethyst","owner":"imagineeeinc","description":"A beautiful discord music bot","archived":false,"fork":false,"pushed_at":"2024-07-22T11:42:38.000Z","size":348,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-17T11:50:44.780Z","etag":null,"topics":["bot","discord","discord-bot","discord-music-bot","music"],"latest_commit_sha":null,"homepage":"https://imagineee.web.app/projects/Amethyst","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imagineeeinc.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":"2022-05-11T19:01:10.000Z","updated_at":"2024-07-22T11:42:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"a575768a-add1-4f89-b7b8-0dc58163690d","html_url":"https://github.com/imagineeeinc/Amethyst","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/imagineeeinc/Amethyst","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagineeeinc%2FAmethyst","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagineeeinc%2FAmethyst/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagineeeinc%2FAmethyst/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagineeeinc%2FAmethyst/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imagineeeinc","download_url":"https://codeload.github.com/imagineeeinc/Amethyst/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagineeeinc%2FAmethyst/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271444830,"owners_count":24760905,"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","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-bot","music"],"created_at":"2024-11-17T03:19:12.550Z","updated_at":"2026-02-12T04:18:16.505Z","avatar_url":"https://github.com/imagineeeinc.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\t\u003cimg src=\"amethyst.png\" width=\"30%\"\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003eAmethyst\u003c/h1\u003e\n\u003ch3 align=\"center\"\u003eA beautiful discord music bot\u003c/h3\u003e\n\nAmethyst is a clean beautiful music bot for discord, built around the ideas of simplicity and ease of use.\n\nAmethyst is also open source so you can host your own versions of it.\n\n\u003ch2 align=\"center\"\u003eAdding the community version to your server\u003c/h2\u003e\n\nAdding the already deployed version to your server. Is simple as 1,2,3,4,5\n1. click the bot adding link: [here](https://discord.com/api/oauth2/authorize?client_id=974030969256411157\u0026permissions=397317107024\u0026scope=bot%20applications.commands)\n2. Choose the server to add to\n3. Click Continue\n4. Authorize it\n5. Go to the server and run `/help`\n\n### Downside to using community version\n- Sometime shutdowns for maintenance, testing and upgrading\n- not always up to date\n- Slower on average (depends on the distance between host servers and discord servers)\n\nIt is recommended to deploy your own unless you are not a developer.\n\u003ch2 align=\"center\"\u003eDeploying your own instance\u003c/h2\u003e\n\nDeploying your own bot instance is simple as hosting it on any cloud provider.\n\n### Prerequisites\n- Node LTS (This was tested on Node 16)\n- FFMPEG is installed (you can also run `npm install ffmpeg-static` in the root of the project)\n- Setup discord bot from the [discord developer dashboard](https://discord.com/developers/), there are many tutorials on how to setup a bot online\n- Environment Variables\n\t- `TOKEN: \u003cBot Token\u003e`\n\t- `CLIENT_ID: \u003cThe application id\u003e`\n\t- `GUILD: \u003cthe specific server to deploy commands to\u003e` Optional\n\n### Env alternative\nAn alternative to using environment variables is using a config file. Create a `config.json` in the root folder, and use this template bellow and fill out the correct values.\n```json\n{\n\t\"token\": \"bot-token\",\n\t\"clientId\": \"app-id\",\n\t\"guild\": \"server-id\"\n}\n```\n### Running it\nSimply install all the dependencies with `npm install`.\n\nTo deploy the slash commands, run: `npm run deploy-commands`\n\nTo run the standalone bot, run: `npm run bot`\n\nTo deploy commands and run the bot in one command, run: `npm start` \n\n### Deploying Using Docker\nThere is a Docker file provided, so just build the image and run the container in the root of the project, provide ENV Variables(or use the [env alternative](#env-alternative)) and it should work.\n\n\u003ch2 align=\"center\"\u003eLicense\u003c/h2\u003e\n\nThis bot/ project is under [TCI](https://github.com/imagineeeinc/Amethyst/blob/main/LICENSE) License.\n\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://imagineee.web.app/\"\u003e\n  \t\t\u003cimg src=\"https://imagineeeinc.github.io/made-with-love-by-imagineee/made-with-love-lavender.svg\" alt=\"Made with love by imagineee\" height=\"64px\"\u003e\n\t\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimagineeeinc%2Famethyst","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimagineeeinc%2Famethyst","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimagineeeinc%2Famethyst/lists"}