tube galaxy v1.0.0
/// open source · self-host · byo api keys

936 subs. 12 subgenres. One galaxy.

YouTube gives you a flat list of every channel you've ever followed. Tube Galaxy turns it into an actual map — niche-classified channels, music artists tagged by subgenre, and a 3D globe pinning every concert near you.

Self-host with your keys See a live demo (mine)
936 subscriptions 272 playlists 949 liked videos 12 music subgenres 3D concert globe

YouTube gives you a list. Not a map.

You've subscribed to 936 channels over a decade. Some you watch weekly. Some you forgot existed. Some are Plastikman live sets from Movement Detroit; some are FFmpeg tutorials. They all live in the same flat sidebar. Tube Galaxy taxonomizes them — niche, then subgenre, then artist — so you can actually find what you signed up for.

01

Twelve music subgenres. Auto-classified.

Gemini reads each channel's name, description, and recent video titles. Maps them onto subgenres with confidence scores. The artist sidebar groups subscriptions you didn't know were related.

02

949 concerts. One 3D globe.

For every artist you sub to, Tube Galaxy queries Ticketmaster Discovery and Bandsintown for upcoming shows. Pins drop on a Globe.gl render colored by subgenre. Click a pin → see the artist + venue + date. Click an artist → see every concert they've ever announced.

Open the live globe

Loads my actual data: 949 concerts, 12 subgenre-colored pins, Globe.gl 3D rotation. ~500KB.

03

Five steps. Run them on your data.

Extract → categorize → enrich → concerts → render. Each step is one Python script. Run them in order. Output is JSON your browser reads.

04

What you get back, per account.

→ 01

Subscription Universe

Sidebar shows every niche (Music · Tech · Documentaries · etc.). Click a niche → expandable card list of every channel in it with thumbnail, recent uploads, and click-through to YouTube.

→ 02

Music Artists tab

12 subgenre tabs (techno · house · ambient · D&B · etc.) with track lists, recent uploads, and Bandsintown integration.

→ 03

Concert Globe

Globe.gl 3D render. Pins colored by subgenre. Click any pin → artist name, venue, date, ticket link.

→ 04

Quota-aware extraction

UC→UU playlist trick to fetch latest videos in 1 quota unit instead of 100.

→ 05

Gemini batched

12 channels per batch, 5s throttle for the 15 RPM free tier.

→ 06

Concert sources

Ticketmaster Discovery (5,000 req/day free) + Bandsintown public artist endpoint. Both quotas live in your account.

→ 07

Re-run anytime

npm run pipeline regenerates everything. Cron it nightly if you want.

→ 08

Static deploy

Output is plain HTML + JSON. Vercel · Netlify · GH Pages — all work.

05

Things you'd ask before cloning the repo.

Self-host. Your keys. Your data.

No SaaS. No account. No tokens leaving your machine. Bring your own Google OAuth + Gemini API key.

Clone on GitHub

or see my live version with real data