meeb/tubesync
Tubesync
TubeSync is a containerized media management tool and self-hosted archiver designed to automate the downloading and organization of video content from online sources, such as YouTube channels and playlists, into a local library for offline access. It functions as a download manager and metadata generator, utilizing a web interface to manage video subscriptions and synchronization settings.
The system features a rule-based content filter that evaluates video metadata against user-defined conditions to determine which items enter the download queue. To handle restricted or age-gated content, it supports browser cookie authentication to bypass standard OAuth flows.
The platform covers broad capabilities including automated content mirroring, the generation of sidecar metadata files for portable organization, and synchronization with external media servers. It includes a database-backed task queue for sequential processing, support for external database connectors, and a command-line interface for task management.
The service is provided as a Dockerized application with a web-based dashboard protected by HTTP basic authentication.
Features
- Automated Video Archivers - Downloads videos from specified channels and playlists based on preferred quality and format settings.
- YouTube Archiving - Automates the downloading and indexing of entire YouTube channels and playlists for offline access.
- Media Automation Tools - Offers a containerized service for automating media library management and content synchronization.
- Media Servers - Organizes content and metadata to ensure compatibility with external playback software and media servers.
- Metadata Organizers - Generates and manages sidecar metadata files to ensure video collections remain searchable and portable.
- Self-Hosted Media Managers - Provides a private platform for storing, labeling, and synchronizing a personal video library.
- Scheduled Content Updates - Tracks channels and playlists by validating URLs and scheduling periodic checks for new content.
- Portable Metadata Storage - Stores media metadata as sidecar files alongside downloaded content to enable offline access and portability.
- Sidecar File Persistence - Writes media information to separate sidecar files to ensure offline portability and recovery.
- Remote Content Mirroring - Schedules recurring checks to mirror remote video assets locally for permanent offline availability.
- Metadata Synchronization - Creates and synchronizes information files for videos to ensure consistent labeling and organization.
- Self-Hosted Archiving Systems - Implements a system for downloading and managing long-term archives of video content on private infrastructure.
- Rule-Based Filters - Evaluates video metadata against user-defined conditions to determine if content enters the download queue.
- Video Content Filtering - Applies custom logic and criteria based on video metadata to determine which content is synchronized.
- Restricted Content Downloaders - Uses browser cookies and authentication tokens to download restricted or age-gated media.
- Cookie-Based Session Authentication for Downloads - Uses imported browser cookies to authenticate and download restricted or age-gated media content.
- Local Media Bulk Importers - Scans local directories to import previously downloaded videos into the system without re-downloading.
- Task Queues - Manages download tasks in a database, processed sequentially by a worker process with real-time updates.
- Relational Database Backends - Supports PostgreSQL, MySQL, and MariaDB as alternative storage backends with automatic schema migrations.
- Database Backend Integration - Supports connecting to remote database systems instead of local storage for improved scalability.
- Metadata Generators - Extracts media information and stores it as sidecar files for consistent labeling and organization.
- Plugin-Based Source Abstractions - Utilizes separate adapter modules for each media source to abstract authentication and download logic.
- Automation - Automated synchronization of YouTube channels to local media servers.
- Automation Tools - Listed in the “Automation Tools” section of the Awesome Selfhosted awesome list.
- Video Streaming - PVR for syncing YouTube channels to local media servers.
