Your self hosted YouTube media server

tubearchivist-github-star tubearchivist-docker tubearchivist-docker tubearchivist-discord

Browser Extension: Tube Archivist Companion

tubearchivist-chrome tubearchivist-firefox

Core functionality

  • Subscribe to your favorite YouTube channels
  • Download Videos
  • Index and make videos searchable
  • Play videos
  • Keep track of viewed and unviewed videos

Problem Description

Once your YouTube video collection grows, it becomes hard to search and find a specific video. That's where Tube Archivist comes in: By indexing your video collection with metadata from YouTube, you can organize, search and enjoy your archived YouTube videos without hassle offline through a convenient web interface.

Latest Release:

Release tag: v0.3.6

Release date: 2023-05-13

Project Updates

  • This update will automatically change and rebuild the video, channel and download queue indexes.
  • Tube Archivist Companion browser extension also got an update to control auto start behavior: Release Notes
  • If you are a sponsor, the real time monitor client also got an update to control auto start behavior: Release Notes
  • At first start, there is a migration command running to index additional metadata from your media files. That includes file size, codec, bitrate, resolution. To improve reliability of that process, this first triggers a Rescan Filesystem command to validate all media file paths. Make sure you have all media files mounted before updating.
  • That process can take some time, depending on various factors, expect this to take around 1 minute per 1000 videos.
  • Log output will show progress and any error messages.
  • The interface will become available again, after that completes.
  • Be patient and grab some popcorn to watch the logs fly by.


  • Added video stream metadata indexing like codecs, bitrate, filesize
  • Added channel metadata aggregation like total file size, total videos, total playback.
  • Added start now for adding to download queue, docs
  • Added auto start for subscriptions, docs
  • Added extractor language configuration, docs
  • Added --format-sort configuration, docs, by @dsander
  • Added channel tags indexing for better search results
  • [API] Added endpoints to control auto start behavior


  • Changed channel metadata extraction to use yt-dlp instead of custom scraper for better reliability.
  • Removed the limit_count config field, use queue control instead


  • Fixed backup run issue when not initiated with task
  • Fixed playlist ID parser for members only playlists, by @mglinski