tubearchivist

tubearchivist: Archive and Stream YouTube Videos Yourself

Tube Archivist is a self-hosted YouTube media server built around yt-dlp for downloading videos. It indexes your collection for search and playback through a web interface, with Docker-based deployment.

ActivePythonGPL-3.0Self HostedDockerVideo
Stars
8.6k
Forks
433
Stars, last 30 days
+82
Last commit
8 days ago
Contributors
87

Our take

Activeregular commits and releases

Health score

49/100

How it is scored
Activity
60
Community
52
Issues
57
Pull requests
28

+82 stars in the last 30 days

  • More contributors than 75% of the projects we track
  • Slower to merge pull requests than 96% of the projects we track

Tube Archivist is an actively maintained, feature-rich choice for self-hosted YouTube archiving, though its development is concentrated in one contributor and it requires a multi-service Docker setup.

Good fit if

  • You want channel subscriptions, yt-dlp downloads, searchable indexing, and playback in one self-hosted service.
  • You can run Docker Compose with Elasticsearch and Redis, and have enough memory and CPU for the stack.
  • GPL-3.0 licensing fits your deployment and distribution plans.

Look elsewhere if

  • You need a lightweight downloader without a separate indexing and media-server stack.
  • You need flexible media-file naming or guaranteed support for every browser codec.
  • Your workflow depends on downloads that yt-dlp cannot retrieve, or on audio-download and podcast features that remain on the roadmap.
All health signals
Last commit2026-10-25 (8 days ago)
Commits, last 90 days60
Releases, last 12 months6 (latest v0.6.0, 2026-10-25)
Contributors87 (top contributor: 88% of commits)
Issues closed, last 90 days28 (typically closed in 32 days)
Pull requests merged, last 90 days5 (typically merged in 14 days)
Project age5 years

Checked on 2026-11-03 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

8,597

Forks

436

Change since Nov 14, 2026: 0 stars·+2 forks

Overview

Tube Archivist is a self-hosted YouTube media server built around yt-dlp, the video downloader. It helps people with growing video collections archive videos, index YouTube metadata, and search and play their collection through a web interface, including when offline.

The project is aimed at people willing to run a Docker-based service and its supporting components. It brings channel subscriptions, downloads, searchable indexing, playback, and watched-state tracking together rather than leaving you to manage a collection with yt-dlp alone.

Key Features

  • Subscribe to YouTube channels and queue videos, channels, playlists, or individual links for download.
  • Download videos using yt-dlp.
  • Index videos and metadata for search.
  • Play archived videos through a web interface and track viewed and unviewed items.
  • Schedule subscription rescans and downloads.
  • Download and index subtitles and comments, and use SponsorBlock integration.
  • Import existing video files into the indexed collection.

Use Cases

  • A YouTube viewer wants a searchable, offline-accessible archive of subscribed channels.
  • A household wants to organize and track watched videos in a shared self-hosted library.
  • A home-lab user wants a web interface for managing YouTube downloads rather than running yt-dlp jobs manually.
  • A Jellyfin or Plex user wants to make archived videos available through those services using the linked plugins.

What you need

Detected in the repository

  • Python (main language on GitHub)
  • A Dockerfile, so it can run in a container; a Compose file sets up the related services
  • Automated checks on GitHub Actions

License in plain words

GPL-3.0strong copyleft

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license notice
  • Share your changes: yes, the full source of anything you distribute that includes it, under the GPL
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Use the project's Docker Compose example to configure and start the service. See the installation documentation for environment variables and setup details, and the README for the full guide.

Alternatives

  • cobalt: Cobalt downloads media from supported links on demand, while Tube Archivist builds a searchable, browsable archive of YouTube videos.
  • YTSage: YTSage is a desktop yt-dlp downloader for saving videos and playlists, while Tube Archivist is a self-hosted web archive with indexing and playback.
ProjectLanguageLicenseStarsStatus
tubearchivistPythonGPL-3.08.6kActive
cobaltSvelteAGPL-3.044.7kQuiet
YTSagePythonMIT4.7kActive

Considerations

  • The project is active, with recent commits and releases and ongoing issue and pull-request activity. It has many contributors, but most code contributions come from one person, which is a concentration risk.
  • Deployment requires Docker and a stack that includes Elasticsearch and Redis. The README estimates around 2 GB of available memory for a small test setup and around 4 GB for a mid-to-large installation; Elasticsearch also has host kernel and storage-permission requirements.
  • Playback depends on browser codec support, and the project notes that yt-dlp's limitations also apply to its downloads.
  • The README says media-file naming is not flexible. Audio downloads and podcast mode are listed as roadmap items rather than implemented features.

Found this useful?

Share it with someone who would like tubearchivist.

Comparisons