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: 5 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 (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2026-01-16T11:43:51.000Z (9 days ago)
• Last Synced: 2026-01-17T17:46:59.825Z (7 days 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: 123 MB
• Stars: 862
• Watchers: 5
• Forks: 44
• Open Issues: 21
• 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 Invidious.

  



 

-------

![Preview of homepage](./previews/home-preview.png)

# Features

- [Invidious companion support.](./docs/DOCKER.md#invidious-companion-support)

- [Invidious API extended integration.](https://github.com/Materialious/api-extended)

- [YouTube.js](https://github.com/LuanRT/YouTube.js) fallback if Invidious fails loading videos for Desktop & Android.

- Android TV support

- Support for disabling certificate validation for homelab users.

- Sync your watch progress between Invidious sessions.

- Watch sync parties.

- Sponsorblock built-in.

- [Return YouTube Dislike](https://github.com/Anarios/return-youtube-dislike) (RYD) built-in.

- [DeArrow](https://github.com/ajayyy/DeArrow) built-in (With local processing fallback).

- No ads.

- No tracking.

- Light/Dark themes.

- Custom colour themes.

- Integrates with Invidious subscriptions, watch history & more.

- Live stream support.

- Dash support.

- Chapters.

- Audio only mode.

- Mini player (PIP.)

- Playlists.

- PWA support.

- YT path redirects (So your redirect plugins should still work!)

# Support table

|         | Dash | HLS | Local video fallback | API-Extended | Dearrow | RYD | Watch Parties |

|---------|------|-----|----------------------|--------------|---------|-----|----------------|

| Web     | ✅    | ✅   | ❌                    | ✅            | ✅       | ✅   | ✅              |

| Desktop | ✅    | ✅   | ✅                    | ✅            | ✅       | ✅   | ❌              |

| Android | ✅    | ✅   | ✅                    | ✅            | ✅       | ✅   | ❌              |

# Deploying as a website via docker

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

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