tubesync

Product Overview

TubeSync is a Personal Video Recorder (PVR) for YouTube, designed to synchronize channels and playlists from the popular video-sharing platform to local directories and update your media server once media is downloaded. This innovative project enables users to watch YouTube videos in their preferred quality or settings directly from their local media server.

Main Features

TubeSync offers a range of features that set it apart from other web interfaces to YouTube and yt-dlp:

• PVR Experience: TubeSync provides a full PVR experience, updating your media server once media is downloaded.
• Media Format Selection: The project offers better selection of media formats, allowing users to choose the format they prefer.
• Gradual Retrying of Failures: TubeSync has implemented gradual retrying of failures with back-off timers, making it a reliable option for downloading media.
• Task Scheduler: The project uses an internal task scheduler, ensuring that tasks are performed automatically on a timer.
• Integration with Media Servers: Currently, TubeSync supports Plex as a media server, allowing users to add their local Plex server and manage their media library.

Getting Started

To use TubeSync, you'll need:

• An environment to run containers such as Docker or Podman
• Sufficient disk space to allocate for downloaded media and thumbnails

Once installed, adding sources is as simple as clicking "Add Source" and waiting for the indexing process to complete. All other actions are automatic and performed on timers by scheduled tasks.

Additional Features

TubeSync also offers:

• Logging and Debugging: The project outputs useful logs, errors, and debugging information to the console.
• Advanced Usage Guides: TubeSync provides guides for more complex and less common features, including importing existing media, resetting tasks, and using PostgreSQL, MySQL, or MariaDB as database backends.

Warnings

When using TubeSync, keep in mind:

• Index Frequency: Try to keep the index frequency as long as possible (up to 24 hours) to avoid excessive resource usage.
• Indexing Massive Channels: Be aware that indexing massive channels may require significant resources and time.