iv-org /invidious

Invidious is an alternative front-end to YouTube

★ 26,022⑂ 2,916👁 205⑃ 1,725● 4,243▤ 41
CrystalAGPL-3.0Created 2018-02-07invidious.io
Download: Release v2.20261114.0Release-2.20261114.0 ↓2.20261114.02026-11-14
+24
Daily
+171
Weekly
+842
Monthly
26,022
stars
2,916
forks
205
watchers
1,725
prs
4,243
issues
41
releases

README

Invidious

  
    
  
  
    
  
  
    
  
  
    
  
  
    
  
  
    
  

  An open source alternative front-end to YouTube

  Website
   • 
  Instances list
   • 
  FAQ
   • 
  Documentation
   • 
  Contribute
   • 
  Donate

  Chat with us:
  
    
  
  
    
  
  
  
  
  
  
  
  
  



 Screenshots

| Player                              | Preferences                         | Subscriptions                         |
|-------------------------------------|-------------------------------------|---------------------------------------|
| !      | ! | ! |
| ! | ! | ! |


 Features

User features
- Lightweight
- No ads
- No tracking
- No JavaScript required
- Light/Dark themes
- Customizable homepage
- Subscriptions independent from Google
- Notifications for all subscribed channels
- Audio-only mode (with background play on mobile)
- Support for YouTube comments
- Available in many languages, thanks to our translators

Data import/export
- Import subscriptions from YouTube, NewPipe and FreeTube
- Import watch history from YouTube and NewPipe
- Export subscriptions to NewPipe and FreeTube
- Import/Export Invidious user data

Technical features
- Embedded video support
- Developer API
- Does not use official YouTube APIs
- No Contributor License Agreement (CLA)


 Quick start

Using Invidious:

- Select a public instance from the list and start watching videos right now!

Hosting Invidious:

- Follow the installation instructions


 Documentation

The full documentation can be accessed online at https://docs.invidious.io/

The documentation's source code is available in this repository:
https://github.com/iv-org/documentation

 Extensions

We highly recommend the use of Privacy Redirect,
a browser extension that automatically redirects YouTube URLs to any Invidious instance and replaces
embedded YouTube videos on other websites with Invidious.

The documentation contains a list of browser extensions that we recommended to use along with Invidious.

You can read more here: https://docs.invidious.io/applications/


 Contribute

 Code

1.  Fork it ( https://github.com/iv-org/invidious/fork ).
1.  Create your feature branch (git checkout -b my-new-feature).
1.  Stage your files (git add .).
1.  Commit your changes (git commit -m 'Add some feature').
1.  Push to the branch (git push origin my-new-feature).
1.  Create a new pull request ( https://github.com/iv-org/invidious/compare ).

 Translations

We use Weblate to manage Invidious translations.

You can suggest new translations and/or correction here: https://hosted.weblate.org/engage/invidious/.

Creating an account is not required, but recommended, especially if you want to contribute regularly.
Weblate also allows you to log-in with major SSO providers like GitHub, GitLab, BitBucket, Google, ...


 Projects using Invidious

A list of projects and extensions for or utilizing Invidious can be found in the documentation: https://docs.invidious.io/a

Top issues

Latest release

Release v2.20261114.0 v2.20261114.0 2026-11-14
Wrap-up

This release updates the project to Crystal 1.22.3, ensuring compatibility with the latest language features and improvements. No user-facing changes are included; this is a maintenance release for developers and instance owners.

 New features & important changes

The only important changes are the regressions and security issues
that were fixed in Crystal 1.22.3:

https://github.com/crystal-lang/crystal/releases/tag/1.22.3

They are important and everyone using Crystal 1.22.x should update Crystal to 1.22.3 and recompile if needed.

 For Developers and Instance owners.

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON