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