{"id":16345826,"url":"https://github.com/vuthanhtrung2010/spotify-status","last_synced_at":"2025-03-20T23:32:46.569Z","repository":{"id":232734968,"uuid":"785060904","full_name":"vuthanhtrung2010/spotify-status","owner":"vuthanhtrung2010","description":"A flexible spotify status with Next.js","archived":false,"fork":false,"pushed_at":"2025-03-19T15:31:14.000Z","size":3176,"stargazers_count":8,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-19T16:34:42.257Z","etag":null,"topics":["nextjs","postgres","postgres14","postgres16","postgresql","postgresql-database","prisma","prisma-orm","sentry","spotify","spotify-web-api","typescript"],"latest_commit_sha":null,"homepage":"https://spotify.devtrung.tech","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vuthanhtrung2010.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"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":{"ko_fi":"devtrung","paypal":"trungdev"}},"created_at":"2024-04-11T05:42:26.000Z","updated_at":"2025-03-19T15:30:36.000Z","dependencies_parsed_at":"2024-04-18T15:28:26.726Z","dependency_job_id":"1d5bea75-70b3-4294-91fc-0e8b8b1c19dc","html_url":"https://github.com/vuthanhtrung2010/spotify-status","commit_stats":null,"previous_names":["vuthanhtrung2010/spotify-status"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vuthanhtrung2010%2Fspotify-status","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vuthanhtrung2010%2Fspotify-status/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vuthanhtrung2010%2Fspotify-status/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vuthanhtrung2010%2Fspotify-status/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vuthanhtrung2010","download_url":"https://codeload.github.com/vuthanhtrung2010/spotify-status/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244711713,"owners_count":20497415,"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":["nextjs","postgres","postgres14","postgres16","postgresql","postgresql-database","prisma","prisma-orm","sentry","spotify","spotify-web-api","typescript"],"created_at":"2024-10-11T00:33:35.604Z","updated_at":"2025-03-20T23:32:46.563Z","avatar_url":"https://github.com/vuthanhtrung2010.png","language":"TypeScript","funding_links":["https://ko-fi.com/devtrung","trungdev"],"categories":[],"sub_categories":[],"readme":"# Support Server\n\n\u003ca href=\"https://discord.gg/5q6zxM5vnT\"\u003e\u003cimg src=\"https://discord.com/api/guilds/1142287130526224404/widget.png\"\u003e\u003c/a\u003e\n\n# Important notes and thank ❤️\n\nFirst of all, thanks for using this Source Code, it was and is a ton of work to create and maintain it!\nThat's why I'm asking everyone to [**donate a little bit of money**](https://ko-fi.com/devtrung) (via Paypal through ko-fi) or if that's not possible, then join my [Discord Server](https://discord.gg/5q6zxM5vnT)!\n\n# Installation Guide 🔥\n\n## ✅ Hosting Requirements\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick to expand\u003c/summary\u003e\n\n- [nodejs](https://nodejs.org) version 20 or higher, I recommend the latest STABLE version\n- A VPS would be advised, so you don't need to keep your PC/Laptop/RasPi 24/7 online!\n- At least 2GB of RAM \u0026 0.5 - 0.75vCPU with 2GB storage.\n\n\u003c/details\u003e\n\n## 🤖 Website Requirements\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick to expand\u003c/summary\u003e\n\n1. Download the [Source Code](https://github.com/vuthanhtrung2010/spotify-status)\n   - Either by: `git clone https://github.com/vuthanhtrung2010/spotify-status`\n   - Or by downloading it as a zip from a branch\n\n\u003c/details\u003e\n\n## 🤖 Configuration and Starting\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick to expand\u003c/summary\u003e\n\n**NOTE:** _You can do the exact same configuration inside of the `.env.example` file, just make sure to rename it to `.env` or use environment variables!_\n\n1.  Ensure that you have installed all node modules by running `pnpm i`\n2.  Ensure that you have renamed `.env.example` to `.env` and added environment variables\n3.  Now run `pnpm run build` then run `pnpm start` or `pnpm start` or `pm2 start pnpm --name Status -- start` if you using a VPS to run the website as production mode. You can also run the website as developer mode by `pnpm run dev` or `pm2 start \"pnpm run dev\" --name Status`. Might add `npx` to the prefix of `pm2` if you are not using the runtime version!\n4.  Now go to the `/login` route and login to your Spotify Account!\n5.  Enjoy!\n\n\u003c/details\u003e\n\n## ❓ Where to get which Api-Key(s)\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick to expand\u003c/summary\u003e\n\n**NOTE:** _You can do the exact same configuration inside of the `.env.example` file, just make sure to rename it to `.env` or use environment variables!_\n\n1. `./.env`\n   - `client_secret` you can get from: [Spotify Developer Dashboard](https://developer.spotify.com)\n   - `client_id` you can get from: [Spotify Developer Dashboard](https://developer.spotify.com)\n   - `redirect_uri` whatever you set for your domain/website, route `/callback`. Eg: `https://spotify.devtrung.tech/callback`\n   - `DATABASE_URL` get from your self hosted database. See full list of supported database by prisma ORM [here](https://www.prisma.io/docs/orm/reference/supported-databases).\n   - `email` is email that you use to register to Spotify platform.\n   - `PORT` is your port number the website listening to. Default listening port will be 3000.\n   - `SENTRY_AUTH_TOKEN` (optional for who want to track errors/performance): Get it from [Sentry Dashboard](https://sentry.io/settings/auth-tokens/).\n   - `SENTRY_DSN_ADDRESS` (optional for who want to track errors/performance): Get it from your Sentry project.\n   - `BASE_URL` your base URL. Eg: `https://spotify.devtrung.tech`\n\n\u003c/details\u003e\n\n# Contributing\n\n\u003e If you want to help improve the code, fix spelling or design Errors or if possible even code errors, you may create PULL REQUESTS.\n\u003e Please create pull request compare to beta branch, else you will get instant close!\n\u003e Please consider, that [**Vũ Thành Trung**](https://github.com/vuthanhtrung2010) is the main Developer of this project!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvuthanhtrung2010%2Fspotify-status","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvuthanhtrung2010%2Fspotify-status","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvuthanhtrung2010%2Fspotify-status/lists"}