https://github.com/materialious/materialious

Materialious is a modern material design frontend for Invidious, focused on a clean, privacy-friendly YouTube experience. It supports local video fallback when Invidious fails and is available on Web, Desktop, Android, and Android TV.
https://github.com/materialious/materialious

3rd-party android app client custom frontend interface invidious linux macos material privacy self-host smarttv theme tv unraid windows youtube

Last synced: 15 days ago
JSON representation

Materialious is a modern material design frontend for Invidious, focused on a clean, privacy-friendly YouTube experience. It supports local video fallback when Invidious fails and is available on Web, Desktop, Android, and Android TV.

• Host: GitHub
• URL: https://github.com/materialious/materialious
• Owner: Materialious
• License: agpl-3.0
• Created: 2024-03-07T04:19:48.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2026-02-05T14:29:35.000Z (about 2 months ago)
• Last Synced: 2026-02-06T00:58:00.099Z (about 2 months ago)
• Topics: 3rd-party, android, app, client, custom, frontend, interface, invidious, linux, macos, material, privacy, self-host, smarttv, theme, tv, unraid, windows, youtube
• Language: Svelte
• Homepage: https://materialio.us
• Size: 127 MB
• Stars: 888
• Watchers: 5
• Forks: 45
• Open Issues: 30
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
  

  


  


  
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.

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

[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)