HelpFreedom

HelpFreedom / youthub

Public

YouHub — console YouTube client. TUI grid, custom ffplay-yt player, SABR streaming, SponsorBlock, 1080p.

34
8
69% credibility
Found May 27, 2026 at 34 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

youthub is a terminal-based YouTube client that lets you browse your personalized video feed in a visual grid, search for content, and watch videos directly in your terminal window. It connects to your YouTube account using official authentication methods, streams videos using YouTube's own playback technology, automatically skips sponsored segments when available, and records your watch time to your account's history. The experience feels like having YouTube inside your command line—functional, visually appealing, and fully integrated with your Google account.

How It Works

1
🔍 You discover a new way to watch YouTube

Someone tells you about a way to browse and watch YouTube videos right from your terminal, with a beautiful visual grid instead of a web browser.

2
🔑 You connect your YouTube account

You pair your Google account using YouTube's official TV sign-in method, or let the app read your browser cookies so your watch history stays connected.

3
🖼️ You see your personalized home feed

A colorful grid of video thumbnails appears, showing your recommended videos with titles, channels, and view counts—all rendered beautifully in your terminal window.

4
🎮 You browse, search, and explore

Use arrow keys to move between videos, press a key to search for anything, or hover over a video to see a quick animated preview of what it's about.

5
▶️ You press Enter and the video plays

The video streams directly into your terminal window using the same quality as the official YouTube app, with audio playing through your speakers.

6
⏭️ Sponsored segments are automatically skipped

If SponsorBlock has marked parts of the video as sponsorships, those sections are automatically jumped over so you get uninterrupted viewing.

✅ Your watch time is saved to your account

When you finish watching, YouTube records that you watched the video—so it shows up in your watch history and helps improve your recommendations.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 34 to 34 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is youthub?

YouHub is a console YouTube client written in Python that delivers a full visual browsing and playback experience directly in the terminal. It renders video thumbnails in a grid layout, lets you navigate with keyboard controls, and plays content using a custom player built on top of ffmpeg and ffplay. The project reverse-engineers YouTube's SABR streaming protocol to deliver 1080p video without relying on the official API.

Why is it gaining traction?

The appeal is obvious: watch YouTube in your terminal without a browser. It goes further with SponsorBlock integration that skips sponsor segments automatically, and it handles YouTube's bot detection through multiple TLS fingerprint strategies so streams stay reliable. The proxy-friendly design routes all traffic through HTTPS_PROXY by default. Compared to running YouTube in a full browser, this is lightweight and keyboard-driven from the ground up.

Who should use this?

Terminal power users who want YouTube access without leaving their CLI environment. Developers running on headless servers who need programmatic video access. Privacy-conscious users who prefer minimal browser tracking. Anyone working with YouTube stream protocols who wants a reference implementation for experimentation.

Verdict

This is a promising but immature project: 34 stars, limited documentation, and a reverse-engineered protocol that could break when YouTube updates its infrastructure. The 0.70% credibility score reflects that reality. For terminal enthusiasts and developers debugging streaming behavior, it is worth exploring. For casual users expecting stable, hands-off playback, wait for a more documented release.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.