Materialious

Materialious

Docker app from LubricantJam's Repository

Overview

Materialious is a privacy respecting frontend for YouTube built ontop of Invidious.

Readme

View on GitHub


Materialious

Modern material design for YouTube and Invidious.

 

Preview of homepage

Features

  • Internal account system (Optional).
  • 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 (RYD) built-in.
  • 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

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 Windows Download
MacOS (x64 & arm64) MacOS Download
Android
Get it on GitHub

Get it on Obtainium

Get it on F-Droid

Get it on Izzysoft
Android TV For Android TV use APKUpdater.
Flatpak

flatpak install flathub us.materialio.Materialious

Download on Flathub
AppImage Download on Flathub
Debian/Ubuntu Debian/Ubuntu Download

Then run: sudo apt install ./Materialious-linux-amd64.deb
Fedora/OpenSuse Fedora/OpenSuse Download

For Fedora: sudo dnf install ./Materialious-linux-x86_64.rpm

For OpenSuse: sudo zypper in ./Materialious-linux-x86_64.rpm
Linux (tarball) Tarball Download

Translations

Help translate Materialious via Weblate!

Translation status

Previews

Mobile

Android TV Home

Preview of subscriptions page on Android TV

Android TV Player

Preview of player on Android TV

Login

Preview of Login page

Player

Preview of player

Settings

Preview of settings

Channel

Preview of channel

Chapters

Preview of chapters

Playlists

Preview of playlist page Preview of playlist on video page

Have any questions?

Join our Matrix space

Special thanks to

Developers

Install Materialious on Unraid in a few clicks.

Find Materialious in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Materialious Review the template variables and paths Click Install
Explore Unraid OS

Requirements


        For security reasons regarding CORS, your hosted instance of Materialious must serve as the value for the Access-Control-Allow-Origin header on Invidious.
        Invidious doesn't provide a simple way to modify CORS, so this must be done with your reverse proxy.
        Please see the documentation on further information on how to do this if you are unsure.
        https://materialio.us/
    

Categories

Media App > VideoMedia Server > VideoProductivityTools > Utilities

Download Statistics

167,115
Total Downloads
5,380
This Month
6,473
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all
Video appsVideo appsProductivityUtilities apps

Links

Projectgithub.comSupportgithub.comDocker Hubhub.docker.comTemplateraw.githubusercontent.com

Details

Repository
wardpearce/materialious:latest
Registry
https://hub.docker.com/r/wardpearce/materialious/
Last Updated2026-06-23
First Seen2024-06-25

Runtime arguments

Web UI
http://[IP]:[PORT:80]
Network
bridge
Shell
bash
Privileged
false

Template configuration

PortPorttcp
Target
80
Default
3001
Value
3001
Indidious Instance URLVariable

Specify the URL to your proxied Invidious Instance. Do not include a trailing backslash as this will cause issues.

Target
VITE_DEFAULT_INVIDIOUS_INSTANCE
Default
https://invidious.materialio.us
Value
https://invidious.materialio.us
Return YouTube Dislikes URLVariable

Leave blank or delete this variable to disable.

Target
VITE_DEFAULT_RETURNYTDISLIKES_INSTANCE
Value
https://returnyoutubedislikeapi.com
SponsorBlock URLVariable

Leave blank or delete this variable to disable.

Target
VITE_DEFAULT_SPONSERBLOCK_INSTANCE
Value
https://sponsor.ajay.app
DeArrow URLVariable

Specify the URL to your DeArrow Instance.

Target
VITE_DEFAULT_DEARROW_INSTANCE
Default
https://sponsor.ajay.app
Value
https://sponsor.ajay.app
DeArrow Thumbnail Instance URLVariable

Specify the URL to your DeArrow Thumbnail Instance.

Target
VITE_DEFAULT_DEARROW_THUMBNAIL_INSTANCE
Default
https://dearrow-thumb.ajay.app
Value
https://dearrow-thumb.ajay.app
Materialious Default OverridesVariable

Set your default overrides for Materialous. Refer to the documentation for a list of all configurable options.

Target
VITE_DEFAULT_SETTINGS
Value
{"themeColor": "#2596be"}