{"id":13408064,"url":"https://github.com/kittinan/spotify-github-profile","last_synced_at":"2025-04-11T01:29:34.140Z","repository":{"id":37239227,"uuid":"280877685","full_name":"kittinan/spotify-github-profile","owner":"kittinan","description":"Show your Spotify playing on your Github profile","archived":false,"fork":false,"pushed_at":"2024-10-25T21:24:40.000Z","size":179,"stargazers_count":1598,"open_issues_count":20,"forks_count":647,"subscribers_count":19,"default_branch":"master","last_synced_at":"2024-10-29T15:33:48.190Z","etag":null,"topics":["github","github-pages","hacktoberfest","hacktoberfest2020","hacktoberfest2021","hacktoberfest2022","hacktoberfest2024","spotify"],"latest_commit_sha":null,"homepage":"https://spotify-github-profile.kittinanx.com/api/login","language":"Python","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/kittinan.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":"2020-07-19T14:03:10.000Z","updated_at":"2024-10-29T14:03:11.000Z","dependencies_parsed_at":"2022-07-12T16:14:43.749Z","dependency_job_id":"c716cfae-d60e-4d84-9d2c-4d52eb0576ba","html_url":"https://github.com/kittinan/spotify-github-profile","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kittinan%2Fspotify-github-profile","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kittinan%2Fspotify-github-profile/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kittinan%2Fspotify-github-profile/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kittinan%2Fspotify-github-profile/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kittinan","download_url":"https://codeload.github.com/kittinan/spotify-github-profile/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248324804,"owners_count":21084800,"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":["github","github-pages","hacktoberfest","hacktoberfest2020","hacktoberfest2021","hacktoberfest2022","hacktoberfest2024","spotify"],"created_at":"2024-07-30T20:00:50.508Z","updated_at":"2025-04-11T01:29:34.125Z","avatar_url":"https://github.com/kittinan.png","language":"Python","readme":"# spotify-github-profile\n\nCreate Spotify now playing card on your github profile\n\nRunning on Vercel serverless function, store data in Firebase (store only access_token, refresh_token, token_expired_timestamp)\n\n## Annoucements\n\n**2024-06-21**\n\nVercel change the package the free tier is not enough for our usage. I moved service to self-host at Digital Ocean.\n\nPlease replace your old endpoint `https://spotify-github-profile.vercel.app` to `https://spotify-github-profile.kittinanx.com`\n\n## Table of Contents  \n[Connect And Grant Permission](#connect-and-grant-permission)  \n[Example](#example)  \n[Running for development locally](#running-for-development-locally)  \n[Setting up Vercel](#setting-up-vercel)  \n[Setting up Firebase](#setting-up-firebase)  \n[Setting up Spotify dev](#setting-up-spotify-dev)  \n[Running locally](#running-locally)  \n[How to Contribute](#how-to-contribute)  \n[Known Bugs](#known-bugs)  \n[Features in Progress](#features-in-progress)  \n[Credit](#credit)  \n\n## Connect And Grant Permission\n\n- Click `Connect with Spotify` button below to grant permission\n\n[\u003cimg src=\"/img/btn-spotify.png\"\u003e](https://spotify-github-profile.kittinanx.com/api/login)\n\n## Example\n\n- Default theme\n\n![spotify-github-profile](/img/default.svg)\n\n- Compact theme\n\n![spotify-github-profile](/img/compact.svg)\n\n- Natemoo-re theme\n\n![spotify-github-profile](/img/natemoo-re.svg)\n\n- Novatorem theme\n\n![spotify-github-profile](/img/novatorem.svg)\n\n- Karaoke theme\n\n![spotify-github-profile](/img/karaoke.svg)\n\n\n\n## Running for development locally\n\nTo develop locally, you need:\n\n- A fork of this project as your repository\n- A Vercel project connected with the forked repository\n- A Firebase project with Cloud Firestore setup\n- A Spotify developer account\n\n### Setting up Vercel\n\n- [Create a new Vercel project by importing](https://vercel.com/import) the forked project on GitHub\n\n### Setting up Firebase\n\n- Create [a new Firebase project](https://console.firebase.google.com/u/0/)\n- Create a new Cloud Firestore in the project\n- Download configuration JSON file from _Project settings_ \u003e _Service accounts_ \u003e _Generate new private key_\n- Convert private key content as BASE64\n  - You can use Encode/Decode extension in VSCode to do so\n  - This key will be used in step explained below\n\n### Setting up Spotify dev\n\n- Login to [developer.spotify.com](https://developer.spotify.com/dashboard/applications)\n- Create a new project\n- Edit settings to add _Redirect URIs_\n  - add `http://localhost:3000/api/callback`\n\n### Running locally\n\n- Install [Vercel command line](https://vercel.com/download) with `npm i -g vercel`\n- Create `.env` file at the root of the project \n- Paste your keys in `SPOTIFY_CLIENT_ID`, `SPOTIFY_SECRET_ID`, and insert the name of your downloaded JSON file in `FIREBASE`\n\n\n```sh\nBASE_URL='http://localhost:3000/api'\nSPOTIFY_CLIENT_ID='____'\nSPOTIFY_SECRET_ID='____'\nFIREBASE='__BASE64_FIREBASE_JSON_FILE__'\n```\n\n- Run `vercel dev`\n\n```sh\n$ vercel dev\nVercel CLI 20.1.2 dev (beta) — https://vercel.com/feedback\n\u003e Ready! Available at http://localhost:3000\n```\n\n- Now try to access http://localhost:3000/api/login\n\n## How to Contribute\n\n- Develop locally and submit a pull request!\n- Submit newly encountered bugs to the [Issues](https://github.com/kittinan/spotify-github-profile/issues) page\n- Submit feature suggestions to the [Issues](https://github.com/kittinan/spotify-github-profile/issues) page, with the label [Feature Suggestion]\n\n## Known Bugs\n\n[404/500 Error when playing local files](https://github.com/kittinan/spotify-github-profile/issues/19)\n\n## Other Platforms\n- [Apple Music GitHub Profile](https://github.com/rayriffy/apple-music-github-profile)\n\n## Credit\n\nInspired by https://github.com/natemoo-re\n","funding_links":[],"categories":["What to add to your README?","Tools","Python","Miscellaneous","Uncategorized","🛠️ Widgets 👇","Dynamic Content","Resources"],"sub_categories":["14. Include other website stats, Extras.","Uncategorized","Dynamic Badges","Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkittinan%2Fspotify-github-profile","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkittinan%2Fspotify-github-profile","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkittinan%2Fspotify-github-profile/lists"}