Stars
Forks
Watchers
Developer links
HomeTube
Archiving online videos, creator channels, and curated playlists directly into a personal Plex, Jellyfin, or Emby library becomes effortless with HomeTube, a self-hosted web downloader supporting more than 1,800 streaming platforms. Users paste a single video or playlist URL into the web interface, where an intelligent format analyzer evaluates available codecs and automatically selects the highest resolution video and audio streams such as 4K AV1 or VP9 paired with Opus audio. Built-in SponsorBlock integration detects crowd-sourced sponsor segments, intros, outros, and self-promotions during the download process so saved videos play back completely ad-free without manual editing. When synchronizing playlists, the engine tracks entries by unique video ID rather than mutable titles, downloads only newly added items, preserves upstream ordering with customizable filename templates, and optionally moves removed videos into an archive folder. A visual processing panel lets operators trim specific time ranges with keyframe or frame-precise cutting, embed primary and secondary subtitle tracks alongside chapter markers, and create nested destination directories directly from the browser. Browser cookie file support unlocks age-restricted or member-only streams, while custom yt-dlp argument pass-through accommodates proxy routing and filesize caps. Once processing finishes, completed files move into watched media folders and can trigger an immediate Jellyfin library rescan via API key. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. AGPL-3.0 licensed.
Benefits
- Sponsor-Free Media Server Video Downloads
- Automatically strips or marks sponsor reads, intros, outros, and promotional segments using the SponsorBlock database before moving clean video files directly into Plex, Jellyfin, or Emby folders.
- Intelligent Codec and Quality Selection
- Analyzes real stream metadata from over 1,800 platforms to generate primary and fallback quality profiles prioritizing modern AV1 and VP9 video codecs with Opus audio.
- Resilient ID-Based Playlist Synchronization
- Tracks playlist items by immutable video IDs to survive upstream title changes, incrementally fetch new uploads, apply zero-padded index naming patterns, and archive deleted entries.
- Browser-Based Clip Cutting and Subtitles
- Trims video segments using keyframe or precise FFmpeg cutting, embeds multi-language subtitles and chapter markers, and triggers automated Jellyfin library rescans upon download completion.
Features
- yt-dlp 1,800+ Site Engine
- Downloads individual videos and playlists from YouTube, Vimeo, Twitch, TikTok, Reddit, and 1,800+ sites using yt-dlp with custom argument pass-through and cookie authentication.
- Native SponsorBlock Segment Removal
- Queries the SponsorBlock API during post-processing to cut or chapter-mark sponsor segments, self-promotions, and interaction reminders automatically via FFmpeg.
- Adaptive Quality Profile Analyzer
- Inspects available stream formats to build optimal 4K AV1, VP9, and H.264 download profiles with automatic fallback retry logic and manual format ID override.
- Stateful Playlist Sync Engine
- Maintains playlist synchronization with `{idx}`, `{pretty(title)}`, `{channel}`, and `{id}` filename placeholders, smart rename detection, and an optional `Archives/` retention folder.
- Jellyfin and HomeLab Integration
- Organizes completed downloads into nested host folders created from the Streamlit web UI and triggers immediate Jellyfin library scans over REST API.