{"id":15723358,"url":"https://github.com/LumiFae/muusik-api","last_synced_at":"2025-03-12T23:33:04.318Z","repository":{"id":216833894,"uuid":"675101454","full_name":"LumiFae/muusik-api","owner":"LumiFae","description":"The backend / API for muusik.app, built using Node, Hono and discord.js","archived":false,"fork":false,"pushed_at":"2024-08-22T16:44:08.000Z","size":354,"stargazers_count":1,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-10T19:51:12.732Z","etag":null,"topics":["api","bot","discord","discordjs","hono","honojs","music","music-bot"],"latest_commit_sha":null,"homepage":"https://api.muusik.app","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/LumiFae.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"jayxtq","ko_fi":"jxtq"}},"created_at":"2023-08-05T19:27:37.000Z","updated_at":"2024-07-29T17:23:47.000Z","dependencies_parsed_at":"2024-01-23T14:41:49.766Z","dependency_job_id":"69c26043-c9f0-4b26-87e3-6ae80ea6e983","html_url":"https://github.com/LumiFae/muusik-api","commit_stats":null,"previous_names":["jayxtq/muusik-api","lumifae/muusik-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LumiFae%2Fmuusik-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LumiFae%2Fmuusik-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LumiFae%2Fmuusik-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LumiFae%2Fmuusik-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LumiFae","download_url":"https://codeload.github.com/LumiFae/muusik-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243312853,"owners_count":20271159,"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":["api","bot","discord","discordjs","hono","honojs","music","music-bot"],"created_at":"2024-10-03T22:11:18.404Z","updated_at":"2025-03-12T23:33:03.835Z","avatar_url":"https://github.com/LumiFae.png","language":"TypeScript","funding_links":["https://github.com/sponsors/jayxtq","https://ko-fi.com/jxtq"],"categories":[],"sub_categories":[],"readme":"# api.muusik.app\n\nThis is the API for the muusik.app project. This API will allow you to request and post information to and from our Discord bot which can help muusik.app users listen to music directly from their Discord server.\n\n## What is this built on?\n\nThis API is built on Node.JS and Hono.dev (a web framework for APIs). For the Discord bot we are using discord.js and discord-player which does most of the music playing for us.\n\n## Contributing\n\nIf you would like to contribute to this project, please read further here on how to do so.\n\n### Getting started\n\nTo get started with contributing to this project, you will need to have Node.JS installed on your machine. Install it via the [Node.JS Website](https://nodejs.org).\n\nOnce you have Node installed, you will need to fork the repository and clone it to your machine, you can use whatever to clone it. I recommend GitHub Desktop for Windows/MacOS users.\n\nOnce you have cloned the repository, you will need to install the dependencies. You can do so by running the following command in your terminal:\n\n```bash\nnpm install\n```\n\nThis will then install all the dependencies/libraries needed for this project.\n\n### Running the project\n\n\u003e **Warning:** You will need to rename `.env.example` to `.env` and fill in the values for the environment variables before doing this.\n\nTo run the project, you will need to run the following command in your terminal:\n\n```bash\nnpm run dev\n```\n\nThis will then run the project and you will be able to access it on your localhost, for instance `http://localhost:8000` (this is default, unless you change the port in `.env`).\n\n### Hosting the project\n\nHosting the project is more of a personal thing, you can host it locally on a server, or on an off-site cloud server like Heroku. For the original https://api.muusik.app we use Heroku to host the project.\n\nWith Heroku hosting, you can just link your GitHub fork to Heroku and then it will automatically deploy the project for you.\n\nYou also do not need to host the frontend of the project, you can just host the API then use the main website to access your API. To do this you will need to have the original Muusik bot in your server and you will need to be in a VC. Once you are in a VC, go to the dashboard \u003e settings \u003e and then change the API URL to your API URL. **Note:** You have to be the owner of the server to change these settings.\n\n### Making changes\n\nOnce you have made your changes, commit to your fork and then you can go and make a pull request back to the main repository. Once you have done this, I will review your changes and then merge them into the main repository if the changes are good. For more information about making pull requests, check on [GitHub's Docs](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests).\n\n## Issues\n\nIf you find any issues with the project, please create an issue on the repository and I will look into it as soon as possible. For more information about creating issues, check on [GitHub's Docs](https://docs.github.com/en/issues/tracking-your-work-with-issues/creating-issues).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLumiFae%2Fmuusik-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLumiFae%2Fmuusik-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLumiFae%2Fmuusik-api/lists"}