explaingit

iv-org/invidious

Analysis updated 2026-06-21

20,025CrystalAudience · generalComplexity · 4/5LicenseSetup · hard

TLDR

A private, ad-free front end for YouTube, it fetches the same videos but strips out Google tracking, removes ads, and works without a Google account.

Mindmap

mindmap
  root((invidious))
    What it does
      YouTube without ads
      No Google tracking
      Channel subscriptions
      Audio-only playback
    Tech Stack
      Crystal
      Self-hosted server
    Setup Options
      Public instances
      Self-hosted Docker
      Privacy Redirect extension
    Use Cases
      Ad-free viewing
      No Google account needed
      Import YouTube history
      Mobile audio streaming
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Watch YouTube videos without ads or Google tracking by visiting a public Invidious server.

USE CASE 2

Subscribe to YouTube channels and track watch history without creating a Google account.

USE CASE 3

Self-host your own private YouTube front end so subscriber data never touches a third-party server.

USE CASE 4

Listen to YouTube content in audio-only mode on mobile, useful for podcasts and music.

What is it built with?

Crystal

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires setting up a server with Docker, YouTube's backend changes sometimes break Invidious instances until upstream patches are released.

Free to use and modify, but any distributed or hosted version must also be released as open source under AGPL v3.

In plain English

Invidious is an open source alternative interface for watching YouTube. Instead of going to YouTube's website directly, where you get ads, tracking cookies, and algorithms designed to keep you watching, you visit an Invidious instance that fetches the same videos from YouTube behind the scenes and presents them in a clean, minimal interface. The key point is that Invidious never uses YouTube's official APIs, which means YouTube's tracking infrastructure is largely bypassed. The main appeal is privacy and simplicity. Invidious works without JavaScript enabled in your browser, shows no ads, does no tracking, and lets you subscribe to YouTube channels without a Google account. Your subscriptions and watch history live on the Invidious server (or in your own account on a self-hosted instance) rather than in Google's databases. It also supports audio-only playback, useful for listening to video content like podcasts in the background on mobile. You can import your existing YouTube subscriptions and watch history, and export them to other privacy-focused video apps like FreeTube or NewPipe. Anyone can use Invidious right now by picking a public server from a community-maintained list. People who want full control can host their own instance, which also means their data never touches a third-party server. A browser extension called Privacy Redirect can automatically send any YouTube link you click through Invidious instead. The server-side code is written in Crystal, a compiled language with Ruby-like syntax, and the project is licensed under AGPL v3.

Copy-paste prompts

Prompt 1
I want to self-host an Invidious instance on a Ubuntu VPS. Give me the Docker Compose steps from clone to a working YouTube proxy with HTTPS.
Prompt 2
Show me how to export my YouTube subscription list and import it into Invidious so I can follow channels without a Google account.
Prompt 3
Install the Privacy Redirect browser extension and configure it to automatically open all YouTube links through my Invidious instance, show me the exact settings.
Prompt 4
Configure Invidious to enable audio-only playback as the default quality setting so I can use it for background podcast listening on mobile.

Frequently asked questions

What is invidious?

A private, ad-free front end for YouTube, it fetches the same videos but strips out Google tracking, removes ads, and works without a Google account.

What language is invidious written in?

Mainly Crystal. The stack also includes Crystal.

What license does invidious use?

Free to use and modify, but any distributed or hosted version must also be released as open source under AGPL v3.

How hard is invidious to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is invidious for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub iv-org on gitmyhub

Verify against the repo before relying on details.