Automatically updates a pinned GitHub gist to display your recent Spotify top tracks.
Spotify-box is a GitHub Action that automatically updates a pinned GitHub gist with your recent top tracks from Spotify. It solves the problem of manually updating your GitHub profile to reflect your current music taste by automating the process through scheduled workflows. This allows developers to dynamically showcase their listening habits directly on their GitHub profile.
Developers who use GitHub and want to personalize their profiles with dynamic content, particularly those who are active Spotify listeners and enjoy sharing their music preferences.
Developers choose Spotify-box because it provides a fully automated, secure, and visually appealing way to integrate Spotify data into their GitHub presence without requiring manual updates or complex setup.
🎶 Automatic update pinned gist to show your recent Spotify top tracks.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Uses GitHub Actions to schedule periodic refreshes of the gist, ensuring tracks are updated without manual work, as shown in the customizable workflow setup.
Stores sensitive tokens like GIST_ID and SPOTIFY_REFRESH_TOKEN as GitHub Secrets, protecting them from exposure in the codebase, as emphasized in the setup instructions.
Formats top tracks in a pinned gist with a readable layout, making it visually appealing for profile visitors, as demonstrated in the example image.
Allows configuration of update frequency via GitHub Actions workflow, offering flexibility in refresh intervals, mentioned in the key features.
Requires multiple steps including creating a Spotify app, generating tokens, and setting up GitHub secrets, which is time-consuming and error-prone, as detailed in the prep work.
Only supports Spotify, so users of other music services cannot leverage this tool, restricting its utility to a single platform.
Relies on Spotify and GitHub APIs; any changes or downtime could break functionality without user control, as it's not self-hosted or fault-tolerant.