Log inSign up

tijs

obscure-cat

Public
Teal.fm obscure plays index
Edit with AI
1 Branch
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
README.md

obscure.cat

A tiny site for indexing teal.fm ATProto records, storing them locally, and ranking the most obscure tracks by the lowest total listen count across the indexed network.

What it does

  • ingests teal.fm records
  • stores plays in a local DB
  • syncs new matching records on a cron
  • shows the top 10 most obscure tracks on the home page
  • shows who scrobbled each track

Stack

  • Hono
  • Val Town std/sqlite
  • teal.fm fm.teal.alpha.feed.play records

Current routes

  • GET / home
  • GET /health
  • GET /api/top
  • GET /track/:key
  • GET /debug-sentry (throws a test error)
  • GET /admin/status
  • POST /ingest/play
  • POST /admin/backfill

Notes

  • HTTP entrypoint: main.http.ts
  • Firehose cron: cron.ts (Jetstream, every ~5 min)
  • Backfill cron: cron-backfill.ts (Lightrail sweep, hourly)
  • Admin endpoints require x-obscure-cat-admin-token