teal.fm

Start tracking

teal.fm doesn't listen for you. A tracker (a scrobbler) watches what you play and saves each listen to your Atmosphere account, the same account you use for Bluesky, where teal.fm picks it up. Your listens stay in your account, and they're public, just like on Last.fm or ListenBrainz.

Pick one of these to get going. Both run on a computer or server you control.

multi-scrobbler

Watches Spotify, Jellyfin, Plex, Last.fm, ListenBrainz and many more, and scrobbles to teal.fm.

  1. Install it with Docker by following the quickstart. Its dashboard runs on port 9078.
  2. Add a source for wherever you listen, such as Spotify, Jellyfin or Plex.
  3. Create an App Password for your account (on Bluesky: Settings → Privacy and Security → App passwords). Save it; it's only shown once.
  4. Add teal.fm as a client in your docker-compose.yml, with your full handle and that App Password:
    environment:
      - TEALFM_ID=teal
      - TEALFM_IDENTIFIER=alice.bsky.social
      - TEALFM_APP_PW=xxxx-xxxx-xxxx-xxxx
  5. Restart it with docker compose up -d and play something. Your listen shows up under “Just played” on the home page.

piper

teal's own tracker, a small web app that links Spotify, Last.fm, ListenBrainz or Apple Music to your account. Still a work in progress.

  1. Clone the repo and copy .env.template to .env.
  2. Give piper a public URL (a port forward, ngrok or a Cloudflare Tunnel) and use it for SERVER_ROOT_URL and the ATPROTO_* URLs. Set ALLOWED_DIDS if only you should be able to sign in.
  3. Generate its OAuth key and put the secret in ATPROTO_CLIENT_SECRET_KEY, with any unique number (a timestamp works) in ATPROTO_CLIENT_SECRET_KEY_ID:
    goat key generate -t P-256
  4. Turn on the services you use (ENABLE_SPOTIFY, ENABLE_LASTFM, ENABLE_LISTENBRAINZ, ENABLE_APPLEMUSIC) and fill in their keys. The README explains each one.
  5. Start it with Docker, using a version tag from the releases:
    PIPER_IMAGE=ghcr.io/teal-fm/piper:<version> \
      docker compose -f compose.release.yml up -d
    Then open your URL, sign in with your handle, and link your services.

Bring your history

Import your Last.fm scrobbles into your account with malachite, by Ewan Croft.

More tools

People keep building trackers for teal.fm. Find more on Tangled.

Say thanks

multi-scrobbler and malachite are made by independent developers. Consider sponsoring FoxxMD and Ewan Croft. teal.fm takes contributions on Open Collective.

Back to teal.fm