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.
- Install it with Docker by following the quickstart. Its dashboard runs on port 9078.
- Add a source for wherever you listen, such as Spotify, Jellyfin or Plex.
- Create an App Password for your account (on Bluesky: Settings → Privacy and Security → App passwords). Save it; it's only shown once.
- 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 - Restart it with
docker compose up -dand 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.
- Clone the repo and copy
.env.templateto.env. - Give piper a public URL (a port forward, ngrok or a Cloudflare Tunnel) and use it for
SERVER_ROOT_URLand theATPROTO_*URLs. SetALLOWED_DIDSif only you should be able to sign in. - Generate its OAuth key and put the secret in
ATPROTO_CLIENT_SECRET_KEY, with any unique number (a timestamp works) inATPROTO_CLIENT_SECRET_KEY_ID:goat key generate -t P-256 - Turn on the services you use (
ENABLE_SPOTIFY,ENABLE_LASTFM,ENABLE_LISTENBRAINZ,ENABLE_APPLEMUSIC) and fill in their keys. The README explains each one. - Start it with Docker, using a version tag from the releases:
Then open your URL, sign in with your handle, and link your services.PIPER_IMAGE=ghcr.io/teal-fm/piper:<version> \ docker compose -f compose.release.yml up -d
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.