Skip to content
github-actions[bot] edited this page Aug 12, 2026 · 9 revisions

A self-hosted YouTube subscriptions reader with no Google account, no API key, and no recommendation algorithm.

YT Zero reads public YouTube RSS feeds, stores videos in your own SQLite or PostgreSQL database, and gives you a quiet inbox for filtering, scheduling, watching, archiving, and organizing videos from the channels you already care about.

YT Zero main feed

Start here

  • Installation — run with Docker or locally with Bun.
  • Cloud Deployment — one-click and managed-platform deployment.
  • Configuration — environment variables and Docker Compose settings.
  • Features — everything the app does, with screens.
  • Settings — the current settings layout, sections, and access rules.

Using the app

  • Importing Subscriptions — add channels manually, via OPML, or Google Takeout.
  • Profiles — multi-account profiles with isolated per-profile state.
  • Authentication — None, shared login, per-profile login, OIDC, or proxy headers.
  • Child Lock — PIN-protect household settings, configure child content restrictions, and monitor or stop active child viewing.
  • Browser Extensions — improve the embedded player and redirect supported links to your instance.
  • TubeArchivist Integration — use an existing archive as a local source in the normal feed and player.

Operations

Project

  • Development — tech stack, repository layout, and dev workflow.
  • Privacy & License — privacy, trademark notice, limitations, and license.

Clone this wiki locally