{"id":15011434,"url":"https://github.com/rajput-hemant/jiosaavn-api-ts","last_synced_at":"2025-08-07T21:27:20.742Z","repository":{"id":191816895,"uuid":"685451765","full_name":"rajput-hemant/jiosaavn-api-ts","owner":"rajput-hemant","description":"🎵 A simple wrapper for the JioSaavn API powered by Hono.js 🔥.","archived":false,"fork":false,"pushed_at":"2024-12-13T21:51:40.000Z","size":3158,"stargazers_count":22,"open_issues_count":10,"forks_count":30,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-13T22:29:00.220Z","etag":null,"topics":["api","bun-api","bun-runtime","bunjs","honojs","jiosaavn-api","jiosaavn-downloader","music","music-api","nodejs","typescript","vercel"],"latest_commit_sha":null,"homepage":"https://jiosaavn.rajputhemant.tech","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/rajput-hemant.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":"2023-08-31T09:02:06.000Z","updated_at":"2024-12-10T16:51:22.000Z","dependencies_parsed_at":"2023-08-31T23:08:43.450Z","dependency_job_id":"8b233236-1fe6-4ccf-b307-ce353bcfc557","html_url":"https://github.com/rajput-hemant/jiosaavn-api-ts","commit_stats":{"total_commits":120,"total_committers":2,"mean_commits":60.0,"dds":"0.44999999999999996","last_synced_commit":"84b6096f265159f5b04c6a6e04161445eb271c14"},"previous_names":["rajput-hemant/jiosaavn-api-ts"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajput-hemant%2Fjiosaavn-api-ts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajput-hemant%2Fjiosaavn-api-ts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajput-hemant%2Fjiosaavn-api-ts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rajput-hemant%2Fjiosaavn-api-ts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rajput-hemant","download_url":"https://codeload.github.com/rajput-hemant/jiosaavn-api-ts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230501172,"owners_count":18236061,"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","bun-api","bun-runtime","bunjs","honojs","jiosaavn-api","jiosaavn-downloader","music","music-api","nodejs","typescript","vercel"],"created_at":"2024-09-24T19:41:05.615Z","updated_at":"2024-12-19T21:10:33.411Z","avatar_url":"https://github.com/rajput-hemant.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=center\u003e\n\n![][ci] ![][views] ![][stars] ![][forks] ![][issues] ![][license] ![][code-size] ![][commit-activity]\n\n\u003cimg src=\"./public/jiosaavn-2.png\" width=\"200px\"/\u003e\n\n# 🎵 Jio Saavn API\n\n### A simple wrapper for the Jio Saavn API powered by Hono.js 🔥.\n\n[**📚 Documentation**](https://docs-jiosaavn.netlify.app/) (in progress)\n\n## ✨ Features\n\n\u003c/div\u003e\n\n- 🚀 **Ultrafast** - Powered by [Hono.js](https://hono.dev).The router `RegExpRouter` is really fast.\n- 🪶 **Lightweight** - Has minimal dependencies.\n- 🌍 **Multi-runtime** - Works on `Bun`, `Node.js`, `Vercel` or `Cloudflare Workers`. The same code runs on all platforms.\n- 🔥 Download High Quality Songs, w/ lyrics for supported songs.\n- 🎵 Get Songs, Albums, Playlists, Artists, Radio Stations, Podcasts Lyrics, Recommendations, and more.\n- ❤️ Open Source\n\n\u003cdiv align=center\u003e\n\n## 🛠️ Building from source\n\n\u003c/div\u003e\n\n- Clone the repository\n\n```\ngit clone https://github.com/rajput-hemant/jiosaavn-api-ts\ncd jiosaavn-api-ts\n```\n\n- Install dependencies\n\n```\nbun i || pnpm i || npm i || yarn\n```\n\n#### Bun\n\n\u003e **Warning**\n\u003e You need to have [Bun.js](https://bun.sh) installed on your machine to run the project with bun.\n\n```\nbun run dev || pnpm dev || npm run dev || yarn dev\n```\n\n#### Node.js\n\n```\nbun run dev:node || pnpm dev:node || npm run dev:node || yarn dev:node\n```\n\n#### Vercel Dev Server\n\n```\nbun run dev:vercel || pnpm dev:vercel || npm run dev:vercel || yarn dev:vercel\n```\n\n#### Cloudflare Workers\n\n\u003e **Warning**\n\u003e Make sure to remove Node API code from [`src/index.ts`](https://github.com/rajput-hemant/jiosaavn-api-ts/blob/master/src/index.ts) \u0026 [`config.ts`](https://github.com/rajput-hemant/jiosaavn-api-ts/blob/master/src/lib/config.ts#L8) before deploying or running the project with Cloudflare Workers.\n\n[src/index.ts](https://github.com/rajput-hemant/jiosaavn-api-ts/blob/master/src/index.ts)\n\n```diff\n...\n\n-  port: +(process.env.PORT ?? 3000),\n+ port: 3000, # update accordingly\n\n...\n```\n\n[src/lib/config.ts](https://github.com/rajput-hemant/jiosaavn-api-ts/blob/master/src/lib/config.ts#L8)\n\n```diff\n...\n\n-  enableRateLimit: process.env.ENABLE_RATE_LIMIT === \"true\" ?? false,\n+  enableRateLimit: false, # update accordingly\n...\n\n```\n\n```\nbun run dev:vercel || pnpm dev:cf || npm run dev:cf || yarn dev:cf\n```\n\n\u003cdiv align = center\u003e\n\n## 🌐 Deploying your own instance\n\nYou can easily deploy your own hosted version of the `JioSaavn API` by clicking on one of the links below, which will set up a ready-to-go version for you:\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/rajput-hemant/jiosaavn-api-ts)\n\n[![Deploy with Cloudflare Workers](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/rajput-hemant/jiosaavn-api-ts)\n\n**OR**\n\n## Deploying using CLI\n\n\u003c/div\u003e\n\n### Vercel\n\n- It utilizes Edge Functions and can automatically execute in the region nearest to the user who triggers them.\n- It's worth noting that `Mumbai, India (South) - bom1` is the recommended region for this project deployment.\n\n```\nbun run deploy:vercel || pnpm deploy:vercel || npm run deploy:vercel || yarn deploy:vercel\n```\n\n\u003e **Note**\n\u003e We are using community based [🐰 Bun runtime for ▲ Vercel Serverless Functions](https://github.com/vercel-community/bun) by default, You can also use [▲ Vercel Serverless Functions](https://vercel.com/docs/functions/serverless-functions) w/ `Node Runtime` or [▲ Vercel Edge Functions](https://vercel.com/docs/functions/edge-functions) to deploy the project.\n\u003e To use `Node Runtime` or `Edge Functions` rename the `_api` folder to `api` and remove 'buildCommand' from `vercel.json` file.\n\n### Cloudfare Workers\n\n```\nbun run deploy:cf || pnpm deploy:cf || npm run deploy:cf || yarn deploy:cf\n```\n\n### Build and Run Docker Image\n\n#### Docker Compose (Recommended)\n\n- Start the container\n\n```\ndocker-compose up -d # detached mode\n```\n\n- Stop the container\n\n```\ndocker-compose stop # stops the container\ndocker-compose down # stops and removes the container\n```\n\n#### Docker\n\n- Start Docker daemon (Skip if already running)\n\n```\nsudo dockerd\n```\n\n- Build the image\n\n```\ndocker build -t jiosaavn .\n```\n\n- Run the image\n\n```\ndocker run -p 80:3000 jiosaavn\n```\n\n- Open http://localhost to view it in the browser.\n\n- Stop the container\n\n```\ndocker ps\n```\n\n```\ndocker stop \u003ccontainer-id\u003e\n```\n\n\u003cdiv align=center\u003e\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🦾 Contributors:\n\n\u003ca href=\"https://github.com/rajput-hemant/jiosaavn-api-ts/graphs/contributors\" target=\"blank\"\u003e \u003cimg src=\"https://contrib.rocks/image?repo=rajput-hemant/jiosaavn-api-ts\u0026max=500\" /\u003e\n\n\u003c/div\u003e\n\n\u003c!----------------------------------{ Labels }---------------------------------\u003e\n\n[views]: https://komarev.com/ghpvc/?username=jiosaavn-api-ts\u0026label=view%20counter\u0026color=red\u0026style=flat\n[code-size]: https://img.shields.io/github/languages/code-size/rajput-hemant/jiosaavn-api-ts\n[issues]: https://img.shields.io/github/issues-raw/rajput-hemant/jiosaavn-api-ts\n[license]: https://img.shields.io/github/license/rajput-hemant/jiosaavn-api-ts\n[commit-activity]: https://img.shields.io/github/commit-activity/w/rajput-hemant/jiosaavn-api-ts\n[forks]: https://img.shields.io/github/forks/rajput-hemant/jiosaavn-api-ts?style=flat\n[stars]: https://img.shields.io/github/stars/rajput-hemant/jiosaavn-api-ts\n[ci]: https://github.com/rajput-hemant/jiosaavn-api-ts/actions/workflows/ci.yml/badge.svg\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frajput-hemant%2Fjiosaavn-api-ts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frajput-hemant%2Fjiosaavn-api-ts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frajput-hemant%2Fjiosaavn-api-ts/lists"}