mirror of
https://github.com/iv-org/invidious.git
synced 2025-10-29 12:18:29 -05:00
c44778f6c0
* Replace "made with invidious" with "Projects using Invidious" * Use markdown for git commands + add the staging step * Add Quickstart section
153 lines
6.4 KiB
Markdown
153 lines
6.4 KiB
Markdown
<div align="center">
|
|
<img src="assets/android-chrome-192x192.png">
|
|
<h1>Invidious</h1>
|
|
|
|
<a href="https://www.gnu.org/licenses/agpl-3.0.en.html">
|
|
<img alt="License: AGPLv3+" src="https://shields.io/badge/License-AGPL%20v3+-blue.svg">
|
|
</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>
|
|
<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>
|
|
|
|
<h3>An open source alternative front-end to YouTube</h3>
|
|
|
|
<a href="https://instances.invidious.io/">Instances list</a>
|
|
•
|
|
<a href="#documentation">Documentation</a>
|
|
•
|
|
<a href="#contribute">Contribute</a>
|
|
•
|
|
<a href="#donate">Donate</a>
|
|
|
|
<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">
|
|
</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-green">
|
|
</a>
|
|
</div>
|
|
|
|
|
|
## Screenshots
|
|
|
|
| Player | Preferences | Subscriptions |
|
|
|-------------------------------------|-------------------------------------|---------------------------------------|
|
|
|  |  |  |
|
|
|  |  |  |
|
|
|
|
|
|
## Features
|
|
|
|
- Lightweight (the homepage is ~4 KB compressed)
|
|
- No ads
|
|
- No tracking
|
|
- Javascript is 100% optional
|
|
- Tools for managing subscriptions:
|
|
- Only show unseen videos
|
|
- Only show latest (or latest unseen) video from each channel
|
|
- Delivers notifications from all subscribed channels
|
|
- Automatically redirect homepage to feed
|
|
- Import subscriptions from YouTube
|
|
- Audio-only mode (and no need to keep window open on mobile)
|
|
- Dark mode
|
|
- Embed support
|
|
- Set default player options (speed, quality, autoplay, loop)
|
|
- Support for Reddit comments in place of YouTube comments
|
|
- Import/Export subscriptions, watch history, preferences
|
|
- [Developer API](https://docs.invidious.io/API.md)
|
|
- Does not use any of the official YouTube APIs
|
|
- No need to create a Google account to save subscriptions
|
|
- No Code of Conduct
|
|
- No Contributor license Agreement
|
|
- Available in many languages, thanks to [Weblate](https://hosted.weblate.org/projects/invidious/)
|
|
|
|
|
|
## 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
|
|
|
|
### Quick start
|
|
|
|
**Using invidious:** [Select an instance from the list](https://instances.invidious.io) and start watching videos right now!
|
|
|
|
**Hosting invidious:** Just [Follow the installation instructions](https://docs.invidious.io/Installation.md)!
|
|
|
|
### Extensions
|
|
|
|
The documentation contains a list of browser extensions that are recommended to use in addtition to Invidious.
|
|
|
|
You can read more here: https://docs.invidious.io/Extensions.md
|
|
|
|
|
|
## 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 -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 ).
|
|
|
|
### Translations
|
|
|
|
We use [Weblate](https://weblate.org/en/) to manage Invidious translations.
|
|
|
|
You can propose 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
|
|
|
|
- [FreeTube](https://github.com/FreeTubeApp/FreeTube): A libre software YouTube app for privacy.
|
|
- [CloudTube](https://sr.ht/~cadence/tube/): A JavaScript-rich alternate YouTube player.
|
|
- [PeerTubeify](https://gitlab.com/Cha_deL/peertubeify): On YouTube, displays a link to the same video on PeerTube, if it exists.
|
|
- [MusicPiped](https://github.com/deep-gaurav/MusicPiped): A material design music player that streams music from YouTube.
|
|
- [HoloPlay](https://github.com/stephane-r/HoloPlay): Funny Android application connecting on Invidious API's with search, playlists and favoris.
|
|
|
|
|
|
## Donate
|
|
|
|
Bitcoin (BTC): [bc1qfhe7rq3lqzuayzjxzyt9waz9ytrs09kla3tsgr](bitcoin:bc1qfhe7rq3lqzuayzjxzyt9waz9ytrs09kla3tsgr)
|
|
|
|
Monero (XMR): [41nMCtek197boJtiUvGnTFYMatrLEpnpkQDmUECqx5Es2uX3sTKKWVhSL76suXsG3LXqkEJBrCZBgPTwJrDp1FrZJfycGPR](monero:41nMCtek197boJtiUvGnTFYMatrLEpnpkQDmUECqx5Es2uX3sTKKWVhSL76suXsG3LXqkEJBrCZBgPTwJrDp1FrZJfycGPR)
|
|
|
|
|
|
## Liability
|
|
|
|
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.
|
|
|
|
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.
|