2021-07-24 18:48:30 +00:00
|
|
|
<div align="center">
|
2021-07-24 22:14:58 +00:00
|
|
|
<img src="assets/invidious-colored-vector.svg" width="192" height="192" alt="Invidious logo">
|
2021-07-24 18:48:30 +00:00
|
|
|
<h1>Invidious</h1>
|
|
|
|
|
|
|
|
<a href="https://www.gnu.org/licenses/agpl-3.0.en.html">
|
2021-10-22 13:55:20 +00:00
|
|
|
<img alt="License: AGPLv3" src="https://shields.io/badge/License-AGPL%20v3-blue.svg">
|
2021-07-24 18:48:30 +00:00
|
|
|
</a>
|
|
|
|
<a href="https://github.com/iv-org/invidious/actions">
|
|
|
|
<img alt="Build Status" src="https://github.com/iv-org/invidious/workflows/Invidious%20CI/badge.svg">
|
|
|
|
</a>
|
2021-11-26 19:18:12 +00:00
|
|
|
<a href="https://github.com/iv-org/invidious/commits/master">
|
2021-11-02 17:58:22 +00:00
|
|
|
<img alt="GitHub commits" src="https://img.shields.io/github/commit-activity/y/iv-org/invidious?color=red&label=commits">
|
2021-07-24 18:48:30 +00:00
|
|
|
</a>
|
|
|
|
<a href="https://github.com/iv-org/invidious/issues">
|
|
|
|
<img alt="GitHub issues" src="https://img.shields.io/github/issues/iv-org/invidious?color=important">
|
|
|
|
</a>
|
|
|
|
<a href="https://github.com/iv-org/invidious/pulls">
|
|
|
|
<img alt="GitHub pull requests" src="https://img.shields.io/github/issues-pr/iv-org/invidious?color=blueviolet">
|
|
|
|
</a>
|
|
|
|
<a href="https://hosted.weblate.org/engage/invidious/">
|
|
|
|
<img alt="Translation Status" src="https://hosted.weblate.org/widgets/invidious/-/translations/svg-badge.svg">
|
|
|
|
</a>
|
2022-08-07 00:42:08 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
<a href="https://github.com/humanetech-community/awesome-humane-tech">
|
|
|
|
<img alt="Awesome Humane Tech" src="https://raw.githubusercontent.com/humanetech-community/awesome-humane-tech/main/humane-tech-badge.svg?sanitize=true">
|
|
|
|
</a>
|
|
|
|
|
|
|
|
<h3>An open source alternative front-end to YouTube</h3>
|
|
|
|
|
2021-11-02 17:58:22 +00:00
|
|
|
<a href="https://invidious.io/">Website</a>
|
2022-08-07 00:42:08 +00:00
|
|
|
•
|
2021-07-24 18:48:30 +00:00
|
|
|
<a href="https://instances.invidious.io/">Instances list</a>
|
2021-08-25 20:04:03 +00:00
|
|
|
•
|
2022-03-29 20:39:59 +00:00
|
|
|
<a href="https://docs.invidious.io/faq/">FAQ</a>
|
2022-08-07 00:42:08 +00:00
|
|
|
•
|
2021-11-02 17:58:22 +00:00
|
|
|
<a href="https://docs.invidious.io/">Documentation</a>
|
2021-07-24 18:48:30 +00:00
|
|
|
•
|
|
|
|
<a href="#contribute">Contribute</a>
|
|
|
|
•
|
2021-11-02 17:58:22 +00:00
|
|
|
<a href="https://invidious.io/donate/">Donate</a>
|
2022-08-07 00:42:08 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
<h5>Chat with us:</h5>
|
|
|
|
<a href="https://matrix.to/#/#invidious:matrix.org">
|
|
|
|
<img alt="Matrix" src="https://img.shields.io/matrix/invidious:matrix.org?label=Matrix&color=darkgreen">
|
|
|
|
</a>
|
|
|
|
<a href="https://web.libera.chat/?channel=#invidious">
|
|
|
|
<img alt="Libera.chat (IRC)" src="https://img.shields.io/badge/IRC%20%28Libera.chat%29-%23invidious-darkgreen">
|
|
|
|
</a>
|
2021-12-22 00:03:09 +00:00
|
|
|
<br>
|
|
|
|
<a rel="me" href="https://social.tchncs.de/@invidious">
|
2022-05-24 01:55:08 +00:00
|
|
|
<img alt="Fediverse: @invidious@social.tchncs.de" src="https://img.shields.io/badge/Fediverse-%40invidious%40social.tchncs.de-darkgreen">
|
2021-12-22 00:03:09 +00:00
|
|
|
</a>
|
2022-01-10 21:37:44 +00:00
|
|
|
<br>
|
2022-02-16 17:27:03 +00:00
|
|
|
<a href="https://invidious.io/contact/">
|
|
|
|
<img alt="E-mail" src="https://img.shields.io/badge/E%2d%2dmail-darkgreen">
|
2022-01-10 21:37:44 +00:00
|
|
|
</a>
|
2021-07-24 18:48:30 +00:00
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
## Screenshots
|
|
|
|
|
|
|
|
| Player | Preferences | Subscriptions |
|
|
|
|
|-------------------------------------|-------------------------------------|---------------------------------------|
|
|
|
|
| ![](screenshots/01_player.png) | ![](screenshots/02_preferences.png) | ![](screenshots/03_subscriptions.png) |
|
|
|
|
| ![](screenshots/04_description.png) | ![](screenshots/05_preferences.png) | ![](screenshots/06_subscriptions.png) |
|
|
|
|
|
|
|
|
|
|
|
|
## Features
|
|
|
|
|
|
|
|
**User features**
|
|
|
|
- Lightweight
|
|
|
|
- No ads
|
|
|
|
- No tracking
|
|
|
|
- No JavaScript required
|
|
|
|
- Light/Dark themes
|
|
|
|
- Customizable homepage
|
2021-10-22 13:55:20 +00:00
|
|
|
- Subscriptions independent from Google
|
2021-07-24 18:48:30 +00:00
|
|
|
- Notifications for all subscribed channels
|
|
|
|
- Audio-only mode (with background play on mobile)
|
|
|
|
- Support for Reddit comments
|
|
|
|
- [Available in many languages](locales/), thanks to [our translators](#contribute)
|
|
|
|
|
|
|
|
**Data import/export**
|
|
|
|
- Import subscriptions from YouTube, NewPipe and Freetube
|
|
|
|
- Import watch history from NewPipe
|
|
|
|
- Export subscriptions to NewPipe and Freetube
|
|
|
|
- Import/Export Invidious user data
|
|
|
|
|
|
|
|
**Technical features**
|
|
|
|
- Embedded video support
|
2022-03-29 20:39:59 +00:00
|
|
|
- [Developer API](https://docs.invidious.io/api/)
|
2021-07-24 18:48:30 +00:00
|
|
|
- Does not use official YouTube APIs
|
|
|
|
- No Contributor License Agreement (CLA)
|
2017-11-23 07:48:55 +00:00
|
|
|
|
2021-02-24 23:20:19 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
## Quick start
|
2021-02-24 23:20:19 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
**Using invidious:**
|
2020-10-10 12:52:41 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
- [Select a public instance from the list](https://instances.invidious.io) and start watching videos right now!
|
2021-02-24 23:20:19 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
**Hosting invidious:**
|
2020-10-10 12:52:41 +00:00
|
|
|
|
2022-03-29 20:39:59 +00:00
|
|
|
- [Follow the installation instructions](https://docs.invidious.io/installation/)
|
2020-10-10 12:52:41 +00:00
|
|
|
|
2018-09-04 02:42:49 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
## Documentation
|
2020-12-09 18:43:45 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
The full documentation can be accessed online at https://docs.invidious.io/
|
2019-02-16 15:51:09 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
The documentation's source code is available in this repository:
|
|
|
|
https://github.com/iv-org/documentation
|
2019-02-16 15:51:09 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
### Extensions
|
2019-02-11 16:20:55 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
We highly recommend the use of [Privacy Redirect](https://github.com/SimonBrazell/privacy-redirect#get),
|
|
|
|
a browser extension that automatically redirects Youtube URLs to any Invidious instance and replaces
|
|
|
|
embedded youtube videos on other websites with invidious.
|
2019-01-23 20:12:02 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
The documentation contains a list of browser extensions that we recommended to use along with Invidious.
|
2018-01-29 02:31:35 +00:00
|
|
|
|
2022-03-29 20:39:59 +00:00
|
|
|
You can read more here: https://docs.invidious.io/applications/
|
2018-03-09 16:48:01 +00:00
|
|
|
|
2017-11-23 07:48:55 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
## Contribute
|
2019-02-16 15:51:09 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
### 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 -am '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 ).
|
2021-02-24 23:20:19 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
### Translations
|
2019-01-24 18:31:56 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
We use [Weblate](https://weblate.org) to manage Invidious translations.
|
2019-02-16 15:51:09 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
You can suggest new translations and/or correction here: https://hosted.weblate.org/engage/invidious/.
|
2018-08-02 20:18:33 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
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, ...
|
2021-02-24 23:20:19 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
|
|
|
|
## Projects using Invidious
|
2018-12-05 01:22:54 +00:00
|
|
|
|
2020-07-13 08:34:22 +00:00
|
|
|
- [FreeTube](https://github.com/FreeTubeApp/FreeTube): A libre software YouTube app for privacy.
|
2021-02-24 23:57:09 +00:00
|
|
|
- [CloudTube](https://sr.ht/~cadence/tube/): A JavaScript-rich alternate YouTube player.
|
2022-09-28 17:09:13 +00:00
|
|
|
- [PeerTubeify](https://gitlab.com/Cha_de_L/peertubeify): On YouTube, displays a link to the same video on PeerTube, if it exists.
|
2020-07-13 08:34:22 +00:00
|
|
|
- [MusicPiped](https://github.com/deep-gaurav/MusicPiped): A material design music player that streams music from YouTube.
|
2023-03-15 18:11:17 +00:00
|
|
|
- [HoloPlay](https://github.com/stephane-r/holoplay-wa): Progressive Web App connecting on Invidious API's with search, playlists and favorites.
|
2022-03-22 17:41:15 +00:00
|
|
|
- [WatchTube](https://github.com/WatchTubeTeam/WatchTube): Powerful YouTube client for Apple Watch.
|
2022-05-29 17:46:49 +00:00
|
|
|
- [Yattee](https://github.com/yattee/yattee): Alternative YouTube frontend for iPhone, iPad, Mac and Apple TV.
|
2022-06-01 17:48:52 +00:00
|
|
|
- [TubiTui](https://codeberg.org/777/TubiTui): A lightweight, libre, TUI-based YouTube client.
|
2022-08-07 00:42:08 +00:00
|
|
|
- [Ytfzf](https://github.com/pystardust/ytfzf): A posix script to find and watch youtube videos from the terminal. (Without API)
|
2023-02-17 17:08:05 +00:00
|
|
|
- [Playlet](https://github.com/iBicha/playlet): Unofficial Youtube client for Roku TV
|
2023-03-04 20:55:27 +00:00
|
|
|
- [Clipious](https://github.com/lamarios/clipious): Unofficial Invidious client for Android
|
2021-09-15 10:02:43 +00:00
|
|
|
|
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
## Liability
|
2020-10-23 22:02:34 +00:00
|
|
|
|
2021-07-24 18:48:30 +00:00
|
|
|
We take no responsibility for the use of our tool, or external instances
|
|
|
|
provided by third parties. We strongly recommend you abide by the valid
|
|
|
|
official regulations in your country. Furthermore, we refuse liability
|
|
|
|
for any inappropriate use of Invidious, such as illegal downloading.
|
|
|
|
This tool is provided to you in the spirit of free, open software.
|
2020-10-23 22:02:34 +00:00
|
|
|
|
|
|
|
You may view the LICENSE in which this software is provided to you [here](./LICENSE).
|
|
|
|
|
|
|
|
> 16. Limitation of Liability.
|
|
|
|
>
|
|
|
|
> IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
|
|
|
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
|
|
|
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
|
|
|
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
|
|
|
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
|
|
|
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
|
|
|
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
|
|
|
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
|
|
|
SUCH DAMAGES.
|
2021-08-10 22:31:08 +00:00
|
|
|
|
|
|
|
## Change
|
|
|
|
|
|
|
|
Edited the source code of Invidious.<br />
|
|
|
|
The changes are
|
|
|
|
* Changed the region from US to Japan (August 9)
|
|
|
|
* New CSS classes were added (August 9).
|