HomeTube

Overview

HomeTube is a friendly video downloader managing single video URL into organized content structure for automatic home media server experience. HomeTube is a friendly video downloader managing single video URL into organized content structure for automatic home media server experience. - EgalitarianMonkey/hometube The project has 925 GitHub stars and is licensed under AGPL-3.0.

Key Features

Source: GitHub README

• 🎯 One-Click Downloads: Paste URL → Get perfectly organized video
• 🚫 Ad-Free Content: Block videos’ sponsors and ads
• 🎬 Advanced Processing: Cut clips, embed subtitles, convert formats
• ⚙️ Advanced configurations: Set any custom yt-dlp arguments (proxy, max-filesize, etc.)
• 🔐 Cookies Authentication: Essential for reliable downloads - unlocks restricted content and prevents signature errors
• 📊 Quality Control: Auto-select best quality or manual override
• 🧠 Intelligent Caching: Smart URL analysis reuse with quality verification - avoids re-downloading metadata unless format quality improves
• 🎥 Video Sources: YouTube, Reddit, Vimeo, Dailymotion, TikTok, Twitch, Facebook, Instagra, etc. See complete list (1800+) —>
• 🎯 Easy to Use
• Web interface

Getting Started

Source: GitHub README

Environment variables for local run are setup following a specific order:

• First, defined and exported environment variables from the current shell will be taken (export VIDEOS_DIR=/data/videos, set -a && source .env && set +a, etc.)
• Then, if a .env file exists, not defined environment variables from exported shell will be taken from local .env file
• At last, default values will be used for not defined environment variables from shell and .env file

Prerequisites a

Normalized Features

Source: tool-features-normalized.json

docker, docker compose, pip, plugins.