Skip to main content

Spotter

AI-powered music discovery and playlist sync for Navidrome. Aggregate listening history, generate mixtapes with AI DJs, and enrich your music library.

Get StartedDocumentationAPI ReferenceGitHub
🤖 Built by AI. Spotter was written almost entirely by Claude Code (Anthropic). Use at your own risk — no warranty provided. Learn more
13
Specs
22
ADRs
Go
Language
v0.1
Release

Quick Start

Up and running in under a minute with Docker

# Download the compose file
curl -o docker-compose.yml \
  https://raw.githubusercontent.com/joestump/spotter/main/docker-compose.postgres.yml

# Edit with your Navidrome URL, API keys, etc.
$EDITOR docker-compose.yml

# Start Spotter + PostgreSQL
docker compose up -d

View full installation guide →

What Spotter Does

Self-hosted music intelligence — runs alongside your Navidrome instance

🎵
Playlist Sync

Automatically syncs your Navidrome playlists with listening data, keeping your music library in perfect harmony.

View Spec →
🤖
AI Mixtape Engine

Generate personalized mixtapes using LLM-powered curation — like having a DJ who actually knows your taste.

View Spec →
🎤
Similar Artists

Discover new music through intelligent artist similarity analysis powered by your own listening history.

View Spec →
🔐
Secure Auth

Navidrome-backed authentication with AES-256-GCM encryption, secure sessions, and key rotation support.

View Spec →
📡
Live Event Bus

Real-time SSE event streaming keeps every connected client in sync without polling overhead.

View Spec →
📊
Observability

Structured metrics and logging throughout — track sync performance, LLM costs, and system health.

View Spec →

Key Architecture Decisions

22 documented decisions covering every major technical choice

⚡
HTMX + Templ

Server-driven UI without the SPA complexity.

🗄️
SQLite + Ent ORM

Embedded database with type-safe code generation.

🧠
LiteLLM Backend

OpenAI-compatible API for flexible AI provider support.

🎨
Tailwind + DaisyUI

Utility-first styling with component primitives.

Built With

A modern Go stack — small binary, multiple database backends

🐹
Go
Language
🌐
HTMX
UI
🗄️
SQLite / Postgres / MariaDB
Database
🐳
Docker
Deployment
🎵
Navidrome
Music Server
🤖
LiteLLM
AI Backend