TubeHaus: An Open-Source Private YouTube Client and Server
A self-hosted, privacy-focused YouTube interface that eliminates Google account tracking and telemetry.
1Privacy-Focused YouTube Alternative
TubeHaus functions as an independent, open-source YouTube client that operates without requiring a Google account. It provides a familiar interface while ensuring that user subscriptions, watch history, and playlists remain private. By decoupling the viewing experience from Google's tracking mechanisms, it offers a secure alternative for users prioritizing data sovereignty.
2Dual-Mode Architecture Explained
The project offers two distinct deployment methods: a standalone app for individual devices and a server-based version for household-wide usage. The server version centralizes the library, allowing synchronization across multiple platforms including Android TV, Windows, and macOS. Users can choose the setup that best fits their specific privacy and accessibility requirements.
3Invidious Backend Integration
TubeHaus is built upon the Invidious and invidious-companion projects, which handle the complex task of communicating with YouTube's infrastructure. TubeHaus serves as a specialized front-end layer, adding features like live stream support, live captions, and high-quality offline downloads. This modular approach leverages existing open-source tools to ensure robust video delivery.
4Advanced Player Capabilities
The client utilizes Shaka Player to support DASH and HLS streaming protocols, enabling features like storyboard seek previews and ambient mode. It integrates tools such as SponsorBlock and Return YouTube Dislike to enhance the viewing experience. Users can also adjust playback speed, utilize sleep timers, and view detailed video statistics directly.
5Server Requirements and Deployment
Running the server requires a Linux environment with Docker and Docker Compose, supporting both x86-64 and ARM64 architectures. A typical setup needs at least two CPU cores and 4 GB of RAM. The system uses Caddy for HTTPS management, ensuring that the self-hosted instance remains secure and accessible over the network.
6Cloudflare WARP for Egress
To mitigate potential blocking by YouTube, TubeHaus incorporates Cloudflare WARP in proxy mode. This mechanism allows the server to rotate IP addresses and maintain consistent access to video streams. The official WARP client is configured to route traffic, ensuring that the companion service can reliably fetch content without being rate-limited.
7Live Captioning and Processing
The platform includes support for live captions using whisper.cpp, which processes audio streams in real-time. This feature requires additional CPU resources, specifically during active live stream viewing. By handling these intensive tasks on the server side, TubeHaus provides accessibility features that are typically unavailable in standard, third-party YouTube client implementations.
8Data Portability and Migration
TubeHaus emphasizes data ownership by allowing users to import and export their library information. It supports formats from Google Takeout, Invidious, NewPipe, and FreeTube. Users can easily migrate their subscriptions, history, and playlists, ensuring that their data remains portable and never locked into the platform's specific ecosystem or proprietary formats.
9Public Instance Protection
For those hosting public instances, TubeHaus includes built-in protections to manage traffic spikes. It caches requests for popular videos and channels, ensuring that YouTube is queried only once per stream. Idle connections are automatically dropped after 30 seconds, and public instances are configured to avoid pre-loading recommended videos to conserve bandwidth.
10Multi-Language User Interface
The application supports 13 languages, including Korean, English, Japanese, and Turkish. These translations are integrated directly into the codebase, with view counts and date formats adapted to follow regional styles. While no new languages are currently being added, the project welcomes community contributions to maintain and correct existing translation files.
11Independent Software Development
TubeHaus represents a significant effort in creating a user-controlled media consumption environment. By avoiding telemetry and account-based tracking, it provides a transparent alternative to mainstream platforms. As an open-source project, it relies on community feedback and contributions to improve its architecture, security, and overall functionality for privacy-conscious users worldwide.
Original article: Hacker News: Show HN — TubeHaus: An Open-Source Private YouTube Client and Server