# Tube Archivist: Your Self-Hosted YouTube Media Server

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/tubearchivist-tubearchivist
Generated for open source discovery and AI-assisted research.

Tube Archivist is a self-hosted YouTube media server designed to help users organize, search, and enjoy their archived YouTube video collections offline. It allows subscribing to channels, downloading videos using yt-dlp, indexing content with metadata, and playing videos through a convenient web interface. This solution is ideal for anyone looking to maintain a personal, searchable library of their favorite YouTube content.

GitHub: https://github.com/tubearchivist/tubearchivist
OSRepos URL: https://osrepos.com/repo/tubearchivist-tubearchivist

## Summary

Tube Archivist is a self-hosted YouTube media server designed to help users organize, search, and enjoy their archived YouTube video collections offline. It allows subscribing to channels, downloading videos using yt-dlp, indexing content with metadata, and playing videos through a convenient web interface. This solution is ideal for anyone looking to maintain a personal, searchable library of their favorite YouTube content.

## Topics

- self-hosting
- youtube-downloader
- media-server
- video-archive
- python
- docker
- elasticsearch

## Repository Information

Last analyzed by OSRepos: Sat Mar 07 2026 20:11:44 GMT+0000 (Western European Standard Time)
Detail views: 3
GitHub clicks: 3

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

Tube Archivist is your comprehensive self-hosted YouTube media server, designed to bring order and accessibility to your personal YouTube video collection. As your archive grows, finding specific content can become a challenge. Tube Archivist solves this by indexing your videos with rich metadata from YouTube, allowing you to organize, search, and enjoy your archived content offline through a user-friendly web interface. Key functionalities include subscribing to channels, downloading videos using yt-dlp, making videos searchable, playing content, and tracking viewed status.

## Installation

Tube Archivist is designed to run with Docker, making its setup straightforward for users familiar with containerization. A minimal setup requires around 2GB of RAM, with 4GB recommended for mid to large installations, along with a dual-core CPU.

To get started, ensure Docker is installed and running on your system. The project provides a `docker-compose.yml` example, which you'll need to configure with essential environment variables like `TA_HOST`, `TA_USERNAME`, `TA_PASSWORD`, `ELASTIC_PASSWORD`, `REDIS_CON`, and `TZ`.

For detailed, platform-specific instructions, including guides for Unraid, Synology, and Podman, please refer to the [official documentation](https://docs.tubearchivist.com/ "Tube Archivist Documentation" target="_blank"). All environment variables are thoroughly explained [here](https://docs.tubearchivist.com/installation/env-vars/ "Environment Variables Documentation" target="_blank").

## Examples

Once Tube Archivist is up and running, getting started with your archive is simple:

1.  **Configure Settings:** Navigate to the settings page and adjust options, particularly the *Download Format*, to your preferred video quality. For broader compatibility, especially with iOS or macOS, a format like `bestvideo[vcodec*=avc1]+bestaudio[acodec*=mp4a]/mp4` is recommended.
2.  **Subscribe to Channels:** On the *channels* page, subscribe to your favorite YouTube channels.
3.  **Add Videos to Queue:** Go to the *downloads* page, click *Rescan subscriptions* to add videos from subscribed channels, or use *Add to download queue* to manually add video IDs, links, channels, or playlists.
4.  **Start Downloading:** Click *Start download* and let Tube Archivist process your queue.
5.  **Enjoy:** Access and enjoy your organized, archived video collection anytime.

## Why Use It

Tube Archivist offers compelling reasons for anyone looking to take control of their YouTube content:

*   **Offline Access:** Enjoy your favorite videos without an internet connection, perfect for travel or unreliable networks.
*   **Superior Organization and Search:** Move beyond YouTube's interface with powerful indexing and search capabilities, allowing you to quickly find specific videos within a vast collection using metadata.
*   **Self-Hosting Control:** Own your content. Protect your valuable video library from potential platform changes, content removal, or censorship by hosting it yourself.
*   **Rich Feature Set:** Benefit from features like yt-dlp integration for robust downloading, tracking viewed/unviewed status, browser extensions for easy additions, and plugins for integration with popular media servers like Jellyfin and Plex.

## Links

*   **GitHub Repository:** [https://github.com/tubearchivist/tubearchivist](https://github.com/tubearchivist/tubearchivist "Tube Archivist GitHub Repository" target="_blank")
*   **Official Documentation:** [https://docs.tubearchivist.com/](https://docs.tubearchivist.com/ "Tube Archivist Documentation" target="_blank")
*   **Discord Server:** [https://www.tubearchivist.com/discord](https://www.tubearchivist.com/discord "Tube Archivist Discord Server" target="_blank")
*   **Reddit Community:** [https://www.reddit.com/r/TubeArchivist/](https://www.reddit.com/r/TubeArchivist/ "Tube Archivist Subreddit" target="_blank")
*   **Browser Extension:** [https://github.com/tubearchivist/browser-extension](https://github.com/tubearchivist/browser-extension "Tube Archivist Browser Extension" target="_blank")
    *   [Firefox Add-on](https://addons.mozilla.org/addon/tubearchivist-companion/ "Tube Archivist Companion for Firefox" target="_blank")
    *   [Chrome Web Store](https://chrome.google.com/webstore/detail/tubearchivist-companion/jjnkmicfnfojkkgobdfeieblocadmcie "Tube Archivist Companion for Chrome" target="_blank")
*   **Jellyfin Plugin:** [https://github.com/tubearchivist/tubearchivist-jf-plugin](https://github.com/tubearchivist/tubearchivist-jf-plugin "Tube Archivist Jellyfin Plugin" target="_blank")
*   **Plex Plugin:** [https://github.com/tubearchivist/tubearchivist-plex](https://github.com/tubearchivist/tubearchivist-plex "Tube Archivist Plex Plugin" target="_blank")