iv-org

iv-org/invidious

Crystal AGPL-3.0 Media

Invidious is an alternative front-end to YouTube

20.5k stars
2.3k forks
active
GitHub +14 / week

20.5k

Stars

2.3k

Forks

466

Open issues

30

Contributors

AI Analysis

Invidious is a self-hosted, privacy-focused alternative front-end to YouTube that eliminates ads, tracking, and JavaScript requirements. It serves users seeking to watch video content without surveillance or proprietary dependencies, and is particularly valuable for privacy advocates, those on limited bandwidth, and operators of public instances. It is not a general-purpose video platform and requires server infrastructure to deploy.

Media Application Discovery value: 3/10
Documentation 8/10
Activity 9/10
Community 9/10
Code quality 6/10

Inferred from signals mentioned in the README (tests, CI, type safety) — not a review of the actual code.

Overall score 8/10

AI's overall editorial judgment — not an average of the bars above, can weigh other factors too.

youtube-alternative privacy-frontend self-hosted lightweight-streaming open-source-video
Actively maintained Well documented Community favorite Niche/specialized use case Production ready
Deep Analysis · Based on README and public signals
2w ago

Invidious gives privacy-focused users a no-JavaScript, ad-free YouTube front-end they self-host or access via public instances

Invidious is an open-source alternative front-end to YouTube that proxies and renders YouTube content without ads, tracking, or mandatory JavaScript. It targets privacy-conscious users, people in regions with censored YouTube access, and self-hosters who want Google-independent subscriptions. With over 20,000 stars, a documented public API, and a maintained list of live public instances, it has established real-world adoption in the privacy/FOSS community. Its relevance is tightly coupled to YouTube's API stability, making it inherently fragile but also persistently in demand.

Origin

Created in February 2018 by Omar Roth, who later stepped back; the project was forked and continued under the iv-org GitHub organization. It has survived multiple YouTube anti-scraping countermeasures and continues active development as of mid-2026.

Growth

Growth was driven primarily by privacy and de-Googling movements, media coverage of YouTube's data practices, and repeated YouTube API changes that drew developer attention. Star accumulation was steady rather than viral. Zero new stars in the last 7 days suggests the project has reached saturation in its niche rather than active decline.

In production

A publicly maintained instances list at instances.invidious.io documents live deployments worldwide, confirming real-world self-hosted and publicly accessible production usage. The project is referenced in browser extensions like Privacy Redirect and integrated with FreeTube and NewPipe, providing indirect adoption evidence across the privacy-tools ecosystem.

Code analysis
Architecture

Likely a server-side web application written in Crystal that scrapes YouTube without using official APIs. Appears to use a PostgreSQL backend for user data (subscriptions, watch history), and serves an HTML-first interface with optional JavaScript. Public API endpoints are documented separately, suggesting a layered architecture with a web UI and a JSON API layer.

Tests

CI badge is present in README indicating automated build/test pipeline exists; specific test coverage percentage is not documented in README.

Maintenance

Last push was 2026-06-27, the current date, indicating active daily development. Commit activity badge, open issues tracker, and PR tracker are all surfaced in README, suggesting an organized maintenance process. Project has sustained activity for over 8 years, which is strong longevity signal.

Honest verdict

ADOPT IF: you prioritize privacy, want Google-independent subscriptions, need YouTube access without JavaScript, or are in a region with restricted YouTube access. AVOID IF: you need guaranteed uptime or consistent video availability — YouTube's anti-scraping measures can break instances unpredictably and without warning. MONITOR IF: you are building a privacy-tools ecosystem or browser extension that redirects YouTube URLs, as API stability and instance health are ongoing concerns.

Independent dimensions

Mainstream potential

3/10

Technical importance

7/10

Adoption evidence

7/10

Risks
  • YouTube actively works to break unofficial scrapers and front-ends; any significant YouTube-side change can render instances non-functional for hours or days at a time.
  • Written in Crystal, which has a smaller contributor pool than Go, Python, or JavaScript, potentially limiting the number of maintainers who can fix critical issues quickly.
  • Public instances are operated by volunteers with no SLA; reliability and data privacy practices vary widely by instance operator.
  • AGPL-3.0 license may limit adoption in commercial or embedded contexts where license compliance is burdensome.
  • Project sustainability depends on volunteer maintainers and donations; no evidence of institutional or corporate backing to ensure long-term continuity.
Prediction

Invidious will likely continue operating as a maintained niche tool for as long as YouTube remains dominant and privacy concerns persist. Occasional breakage from YouTube countermeasures will keep its user base somewhat volatile but dedicated.

0 found this helpful

Newsletter

Get analyses like this every Monday

Free weekly digest of the most interesting open-source discoveries.

Languages

Crystal
74.7%
HTML
13.1%
JavaScript
8.1%
CSS
2.6%
Shell
1.1%
Dockerfile
0.3%
Makefile
0.2%

Information

Language
Crystal
License
AGPL-3.0
Last updated
6d ago
Created
103mo ago
Analyzed with
anthropic/claude-haiku-4-5

Stars over time

Loading…

Contributors over time

Top 100 contributors only — repos with more will plateau at 100.

Loading…

Similar repos

FreeTubeApp

FreeTubeApp/FreeTube

FreeTube is an open-source desktop YouTube client designed for...

21.4k Vue Media
ViewTube

ViewTube/viewtube

ViewTube is an open-source alternative YouTube frontend enabling ad-free,...

1.5k TypeScript Media
christian-fei

christian-fei/my-yt

my-yt is a self-hosted YouTube frontend that replaces the official YouTube...

1.1k JavaScript Media
yattee

yattee/yattee

Yattee is a privacy-focused video player for iOS, tvOS, and macOS that streams...

3.6k Swift Media
code-charity

code-charity/youtube

A browser extension for YouTube that provides 250+ customization tweaks across...

4.5k JavaScript Productivity
vs. alternatives
Piped

Piped is a newer alternative YouTube front-end written in Java/Vue with a focus on SponsorBlock integration and a more modern UI. It competes directly for the same privacy-user audience. Invidious has broader language support and a longer track record; Piped has a more active instance ecosystem recently.

FreeTube

FreeTube is a desktop application rather than a web front-end; the two are complementary and can share subscription data. Invidious is more accessible (no install required) but requires trusting a third-party instance or running your own server.

NewPipe

NewPipe is an Android-only YouTube client with no JavaScript requirement. Similar privacy goals but different platform and use case. Both support mutual subscription import/export, making them part of the same ecosystem.

youtube-dl / yt-dlp

yt-dlp is a CLI download tool, not a streaming front-end. Different use case, though both circumvent YouTube's official interfaces. Users who want to watch in-browser use Invidious; users who want to download use yt-dlp.

Direct YouTube with uBlock Origin

For many users, running uBlock Origin on YouTube itself is simpler and blocks most ads. Invidious still wins on the no-account/no-tracking/no-JavaScript and censorship-circumvention dimensions, but requires operational overhead.