Skip to content

jherskowitz/spinbin

 
 

Repository files navigation

Spinbin

Turning the web into playlists... one page at a time.

Spinbin scrapes radio station and chart playlists, generates XSPF playlist files, and publishes them via GitHub Pages. Subscribe in Parachord or any XSPF-compatible player.

Playlists

Station Source Add to Parachord XSPF
KEXP Rewind kexp.org Add XSPF
KCRW Rewind kcrw.com Add XSPF
WFMU Rewind wfmu.org Add XSPF
WFUV Rewind wfuv.org Add XSPF
SomaFM Groove Salad Rewind somafm.com Add XSPF
SomaFM Indie Pop Rocks! Rewind somafm.com Add XSPF
XRAY.fm Rewind xray.fm Add XSPF
Vintage Obscura Rewind vintageobscura.net Add XSPF
Radio Paradise Rewind radioparadise.com Add XSPF
NTS Radio Rewind nts.live Add XSPF
WPRB Rewind spinitron.com/WPRB Add XSPF
KALX Rewind spinitron.com/KALX Add XSPF
WMBR Rewind wmbr.org Add XSPF
Bagel Radio Rewind bagelradio.com Add XSPF

How It Works

A GitHub Actions workflow runs once a day at 5am EST, fetches playlist data from source APIs, generates XSPF files, and publishes them to GitHub Pages.

Adding New Stations

  1. Create a scraper in scrapers/ with a fetch_plays() function returning [{"title", "creator", "album", "image"}]
  2. Add an entry to PLAYLISTS in generate.py
  3. Add tests, update pages/index.html and this README

About

Automatically create xspf playlists from online charts

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 55.8%
  • HTML 44.2%