How dezealous/tubeindex works
TubeIndex is a metadata catalogue for YouTube channels. A user submits a handle, channel/video URL, legacy name, or channel ID; the API resolves the channel, fetches and enriches its catalogue, caches results, and streams pages to the browser. The browser can filter and sort results and request TXT, CSV, or JSON exports. Separate capabilities include date-range extraction, RSS-assisted change detection, quota tracking, and rate limiting. The excerpts show the principal endpoint ownership and several service calls; unsampled UI and endpoint details are represented only where documented.
Main entry points: main.py HTTP API · quota.py Quota guard · cache.py SQLite catalogue · streaming.py Video streaming
Components 15
User interface
- Catalogue browser
static/app.js
Catalogue workflow
- HTTP API
app/main.py - Input resolver
app/resolver.py - YouTube client
app/youtube.py - Video streaming
app/streaming.py - SQLite catalogue
app/cache.py - Domain schemas
app/models.py
Quota and access
- Quota guard
app/quota.py - Request limiter
app/ratelimit.py - Runtime settings
app/config.py
Exports and monitoring
- Export generator
app/exports.py - Change detection
app/diff.py
Other components
- Channel user
- YouTube Data API
- YouTube RSS feed
Connections 26
- Channel user → Catalogue browser: submits input
README.md - Catalogue browser → HTTP API: requests catalogue
README.md - HTTP API → Input resolver: resolves input
app/main.py - Input resolver → YouTube client: looks up channel
app/resolver.py - Input resolver → SQLite catalogue: stores channel
app/resolver.py - Input resolver → Quota guard: charges lookup
app/resolver.py - YouTube client → YouTube Data API: requests metadata
app/youtube.py - HTTP API → Video streaming: starts stream
app/main.py - Video streaming → YouTube client: fetches pages
app/streaming.py - Video streaming → SQLite catalogue: reads and writes
app/streaming.py - Video streaming → Quota guard: checks and charges
app/streaming.py - Video streaming → Catalogue browser: streams SSE pages
README.md - HTTP API → SQLite catalogue: loads export data
app/main.py - HTTP API → YouTube client: enriches videos
app/main.py - HTTP API → Quota guard: guards enrichment
app/main.py - HTTP API → Export generator: generates export
app/main.py - Export generator → SQLite catalogue: streams stored rows
app/exports.py - HTTP API → Change detection: runs diff
app/main.py - Change detection → YouTube RSS feed: checks recent IDs
app/diff.py - Change detection → SQLite catalogue: reads and updates
app/diff.py - Change detection → YouTube client: refreshes catalogue
app/diff.py - Change detection → Quota guard: checks and charges
app/diff.py - HTTP API → Request limiter: configures middleware
app/main.py - Request limiter → Runtime settings: uses limits
- Quota guard → SQLite catalogue: records quota
app/quota.py - Quota guard → Runtime settings: reads budget
app/quota.py