whatisxlistening-to

whatisxlistening.to

Last.fm CLI + real-time "now playing" web dashboard.

Live demo: https://whatisbenlistening.to

Quick Start

CLI

# 1. Initialize config
./lastfm init
# Edit ~/.config/lastfm/config.json with your API key

# 2. Test
./lastfm now
./lastfm stats
./lastfm recent

Dashboard

# Docker
docker run -d -p 8765:8765 \
  -e LASTFM_API_KEY=your_key \
  -e LASTFM_USERNAME=your_user \
  -e TZ=America/Los_Angeles \
  ghcr.io/poiley/whatisxlistening.to:latest

# → http://localhost:8765

CLI Commands

Command	Description
lastfm init	Create config file template
lastfm now	Show current/last played track
lastfm stats	Show listening statistics
lastfm recent [N]	Show N recent tracks (default 10)
lastfm backfill	Download full listening history to local DB
lastfm sync	Sync new scrobbles (incremental)
lastfm search <query>	Search local DB by artist/track/album
lastfm db	Show local database statistics

Setup

1. Get Last.fm API Key

1. Go to https://www.last.fm/api/account/create
2. Create an application (any name)
3. Copy your API Key

2. Create Config

./lastfm init
# Then edit ~/.config/lastfm/config.json:

{
  "api_key": "YOUR_API_KEY",
  "username": "YOUR_LASTFM_USERNAME"
}

Clawdbot Usage

User Says	Action
"What am I listening to?"	lastfm now
"My listening stats"	lastfm stats
"What did I listen to recently?"	lastfm recent
"Search for Radiohead"	lastfm search "Radiohead"

---

Dashboard Deployment

Docker

docker run -d -p 8765:8765 \
  -e LASTFM_API_KEY=your_key \
  -e LASTFM_USERNAME=your_user \
  -e DISPLAY_NAME="Your Name" \
  -e TZ=America/Los_Angeles \
  ghcr.io/poiley/whatisxlistening.to:latest

Kubernetes

See k8s/ directory and README.md for full deployment guide with Kustomize.

kubectl create namespace listening-dashboard
kubectl create secret generic lastfm-credentials \
  -n listening-dashboard \
  --from-literal=api_key=YOUR_KEY \
  --from-literal=username=YOUR_USER
kubectl apply -k k8s/

Environment Variables

Variable	Required	Description
LASTFM_API_KEY	✅	Last.fm API key
LASTFM_USERNAME	✅	Last.fm username
DISPLAY_NAME	❌	Name in header (defaults to username)
TZ	❌	Timezone for "today" stats (e.g., America/Los_Angeles)
PORT	❌	Server port (default: 8765)

API Endpoints

Endpoint	Description
GET /	Now playing dashboard
GET /history	Listening history page
GET /healthz	Health check
GET /api/config	{username, display_name}
GET /api/now	Current/last track
GET /api/stats	Listening statistics (total, artists, today, streak)
GET /api/recent?limit=N&page=N	Recent tracks with album art

Files

whatisxlistening.to/
├── SKILL.md              # Clawdbot skill config
├── lastfm                # CLI symlink
├── lastfm_cli.py         # CLI source
├── config.example.json   # Config template
├── server.py             # Dashboard server
├── schema.sql            # SQLite schema
├── Dockerfile
├── README.md
├── web/
│   ├── index.html        # Now playing page
│   └── history.html      # History browser
├── k8s/                  # Kubernetes manifests
└── tests/                # 100% coverage

License

MIT