A Chrome extension that scrobbles NTS Radio tracks to teal.fm
JavaScript 82.8%
CSS 10.3%
HTML 6.9%
11 1 0

Clone this repository

https://tangled.org/chadtmiller.com/nts-teal-piper
git@tangled.org:chadtmiller.com/nts-teal-piper

For self-hosted knots, clone URLs may differ based on your setup.

README.md

NTS Radio Scrobbler for Teal.fm#

A Chrome extension that scrobbles NTS Radio tracks to Teal.fm on the AT Protocol.

NOTE: You need to be an NTS Radio supporter to access the current track/tracklist.

Features#

  • Automatically detects currently playing tracks on NTS Radio
  • Posts track info to your Bluesky feed
  • Auto-scrobble toggle
  • Secure authentication with Bluesky

Installation#

  1. Clone this repository
  2. Open Chrome and navigate to chrome://extensions/
  3. Enable "Developer mode" in the top right
  4. Click "Load unpacked" and select this directory
  5. Create placeholder icons in an icons/ directory (16x16, 48x48, 128x128 PNG files)

Usage#

  1. Click the extension icon to open the popup
  2. Log in with your Bluesky handle/email and password
  3. Visit nts.live and start listening
  4. Tracks will automatically be scrobbled to your Bluesky feed

Setup Icons#

Before loading the extension, create an icons/ directory with three PNG files:

  • icon16.png (16x16)
  • icon48.png (48x48)
  • icon128.png (128x128)

Development#

The extension consists of:

  • manifest.json - Extension configuration
  • content.js - Scrapes track info from NTS Radio
  • background.js - Service worker handling scrobbling logic
  • atproto.js - AT Protocol client
  • popup.html/js - Authentication and settings UI

Notes#

  • The content script may need adjustments if NTS Radio changes their website structure
  • Session tokens are stored locally and refreshed automatically
  • Only works on nts.live domains