/Spotify-Readme

A dynamic, customizable, and real-time Spotify now-playing widget for your README files.

Primary LanguageHTML

Spotify Readme

Badge Badge Badge

A dynamic, customizable, and real-time Spotify now-playing widget for your README files. If you're not currently playing a song, it'll display one of your recent songs! It's width is sized like other common README widgets, so can be uniformly paired (see it in action on my own README). Feel free to ask for help or make any PRs/issues/suggestions 😄

Customization Previews

Just add query parameters to the endpoint, there are many possible combinations! (If you're on mobile and your screen is small, please use a desktop browser or change the zoom level to zoom out)

Parameter Default Values
spin false false, true
scan false false, true
theme light light, dark
rainbow false false, true

Default

/api

Preview

Spinning CD Effect

/api?spin=true

Preview

Include Scan Code

/api?scan=true

Preview

Rainbow Equalizer

/api?rainbow=true

Preview

Dark Theme

/api?theme=dark

Preview

Notes

This wasn't a completely original idea. This is my own version of novatorem's project that was supposed to be for me only, but others have asked for the source code so I made this repo. I also incorporated the latest two PR's from the orignal project into this one and made it easy to customize. I also excluded the Hide the EQ bar and Status String customizations (sorry).

Setup

The setup is slightly different from the original. Please refer to this page for the setup, but take notice of these differences:

  • Use the /api endpoint as opposed to /api/spotify
  • The environment variables are different:
    • SPOTIFY_CLIENT_IDCLIENT_ID
    • SPOTIFY_SECRET_IDCLIENT_SECRET
    • SPOTIFY_REFRESH_TOKENREFRESH_TOKEN