Materialious

Modern Material design for YouTube and Invidious.

Table of Contents

• Features
• Docker deployment
• Legacy Docker deployment, Invidious only
• Installing as a app
• Translations
• Previews
• Have any questions?
• Special thanks to
• Contributing
• License

Features

• Accounts & Syncing
  • Internal account system (optional).
    • Subscriptions are end-to-end encrypted.
    • History & watch progress syncing.
    • Proof-of-work Captcha.
  • Subscription importing/exporting, with automatic Invidious/Materialious import & export.
  • Sync your watch progress between Invidious sessions.
• Invidious & Subscriptions
  • Invidious is optional.
    • Enjoy Materialious without an Invidious instance via our YouTube backend.
    • Local video fallback if Invidious fails loading videos.
  • Invidious companion support.
  • Integrates with Invidious subscriptions.
• Integrations
  • SponsorBlock built-in.
  • Return YouTube Dislike (RYD) built-in.
  • DeArrow built-in.
• Player
  • Chapters.
  • Mini player (PIP).
  • Playlists.
• Platform & Privacy
  • Android TV support.
  • Support for disabling certificate validation for homelab users.
  • No ads.
  • No tracking.
  • Light/Dark themes.
  • Custom colour themes.
  • 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

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...

Please read the guide here

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!

Previews

Have any questions?

Join our Matrix space

Special thanks to

• SecularSteve for creating Materialious' logo.
• Invidious.
• Clipious for inspiration & references to undocumented Invidious routes.
• Beer CSS (Especially the YouTube template what was used as the base for Materialious.)
• LuanRT for YouTube.js & SABR implementation.
• FreeTube for their subtitle fix.
• spotube for using their README layout for local installation.
• Every dependency in package.json.

Contributing

Contributions are welcome! Please read the guidelines below before getting started.

• How Materialious is built
• How to contribute to Materialious
• Code of Conduct

License

Materialious is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).