Materialious

Modern material design for YouTube and Invidious.

------- ![Preview of homepage](./previews/home-preview.png) # Features - Internal account system (Optional). * Subscriptions are end-to-end encrypted. * History & watch progress syncing. * [Proof-of-work Captcha](https://github.com/altcha-org/altcha). - Subscription importing/exporting * Automatically import/export Invidious/Materialious. - Invidious is optional. * Enjoy Materialious without a Invidious instance via our YouTube backend. * Local video fallback if Invidious fails loading videos. - Invidious companion support, including direct companion-base deployments via `VITE_DEFAULT_COMPANION_INSTANCE`. - Android TV support. - Support for disabling certificate validation for homelab users. - Sync your watch progress between Invidious sessions. - Sponsorblock built-in. - [Return YouTube Dislike](https://github.com/Anarios/return-youtube-dislike) (RYD) built-in. - [DeArrow](https://github.com/ajayyy/DeArrow) built-in. - No ads. - No tracking. - Light/Dark themes. - Custom colour themes. - Integrates with Invidious subscriptions. - Live stream support. - Dash support. - Chapters. - Mini player (PIP.) - Playlists. - PWA support. - YT path redirects. # Docker deployment This version of Materialious is feature rich, has its own account system (optional) & is easier to setup. [Please read the guide here](./docs/DOCKER-FULL.md) # Legacy Docker deployment, Invidious only. This version of Materialious is still **fully** supported, but is purely just a Invidious frontend without any fancy bells and whistles, this version is harder to deploy... If your Invidious instance enforces local/proxied playback through companion endpoints, set `VITE_DEFAULT_COMPANION_INSTANCE` to your instance's `/companion` base URL and keep the player defaults aligned with proxied playback (`proxyVideos` and `dashEnabled`). This avoids relying on unsigned root-level media redirects and matches the working companion flow used by Invidious itself. [Please read the guide here](./docs/DOCKER.md) # Installing as a app

Platform	Package/Installation Method
Windows
MacOS (x64 & arm64)
Android
Android TV	For Android TV use APKUpdater.
Flatpak	`flatpak install flathub us.materialio.Materialious`
AppImage
Debian/Ubuntu	Then run: `sudo apt install ./Materialious-linux-amd64.deb`
Fedora/OpenSuse	For Fedora: `sudo dnf install ./Materialious-linux-x86_64.rpm` For OpenSuse: `sudo zypper in ./Materialious-linux-x86_64.rpm`
Linux (tarball)

# Translations Help [translate Materialious via Weblate](https://toolate.othing.xyz/projects/materialious/)!

# Previews ## Mobile

## Android TV Home ![Preview of subscriptions page on Android TV](./previews/android-tv-home.png) ## Android TV Player ![Preview of player on Android TV](./previews/android-tv-player.png) ## Login ![Preview of Login page](./previews/login-previews.png) ## Player ![Preview of player](./previews/player-preview.png) ## Settings ![Preview of settings](./previews/setting-preview.png) ## Channel ![Preview of channel](./previews/channel-preview.png) ## Chapters ![Preview of chapters](./previews/chapter-previews.png) ## Playlists ![Preview of playlist page](./previews/playlist-preview.png) ![Preview of playlist on video page](./previews/playlist-preview-2.png) # Have any questions? [Join our Matrix space](https://matrix.to/#/#ward:matrix.org) # Special thanks to - [SecularSteve](https://github.com/SecularSteve) for creating Materialious' logo. - [Invidious](https://github.com/iv-org). - [Clipious](https://github.com/lamarios/clipious) for inspiration & references to undocumented Invidious routes. - [Beer CSS](https://github.com/beercss/beercss) (Especially the [YouTube template](https://github.com/beercss/beercss/tree/main/src/youtube) what was used as the base for Materialious.) - [LuanRT](https://github.com/LuanRT) for YouTube.js & SABR implementation. - [FreeTube](https://github.com/FreeTubeApp/FreeTube) for their subtitle fix. - [spotube](https://github.com/KRTirtho/spotube) for using their README layout for local installation. - Every dependency in [package.json](/materialious/package.json). # Developers - [How Materialious is built](./docs/BUILDING.md) - [How to contribute to Materialious](./docs/DEV.md)