https://github.com/Materialious/Materialious

Modern material design for Invidious.
https://github.com/Materialious/Materialious

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

Last synced: 13 days ago
JSON representation

Modern material design for Invidious.

• Host: GitHub
• URL: https://github.com/Materialious/Materialious
• Owner: Materialious
• License: agpl-3.0
• Created: 2024-03-07T04:19:48.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-10-29T08:45:13.000Z (6 months ago)
• Last Synced: 2024-10-29T09:56:52.367Z (6 months ago)
• Topics: 3rd-party, android, app, client, custom, design, frontend, interface, invidious, linux, macos, material, privacy, pwa, self-host, theme, unraid, windows, youtube
• Language: Svelte
• Homepage: https://materialio.us
• Size: 74.2 MB
• Stars: 534
• Watchers: 5
• Forks: 24
• Open Issues: 44
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-entertainment - Materialious

README

        

> [!WARNING]  

> Invidious is currently being blocked by Google. Please use Materialious on [Android](https://github.com/Materialious/Materialious/releases/latest) or [Desktop](https://github.com/Materialious/Materialious/releases/latest) to get around this with local video fallback.



  

  


  


  
Materialious

  

    Modern material design for Invidious.

  



 

-------

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

[Help translate Materialious!](https://fink.inlang.com/github.com/WardPearce/Materialious)

# Features

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

  - Sync your watch progress between Invidious sessions.

- Watch sync parties!

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

- Preview video on hover.

- Sponsorblock built-in.

- Return YouTube dislikes built-in.

- DeArrow built-in (With local processing fallback).

- Video progress tracking & resuming.

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

- Playlists.

- PWA support.

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

# Support table

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

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

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

| Desktop | ✅    | ✅   | ✅                    | ✅            | ✅       | ✅   |

| Android | ✅    | ✅   | ✅                    | ✅            | ✅       | ✅   |

# Public instances

[Public instances are listed here](./docs/INSTANCES.md).

Open an issue to add your instance.

# Docker deployment

Deploy Materialious for your Invidious instance using Docker. Follow the steps outlined [here](./docs/DOCKER.md) for easy setup.

# Desktop (Windows/MacOS/Linux)



  

    

  

  

    

  

  

    

  



# Android



  

    

  

  

    

  

  

    

  

  

    

  



# Previews

## Mobile



## Player

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

## Transcript

![Preview of player transcript](./previews/transcript-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 & a good source for learning more about 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.)

- Every dependency in [package.json](/materialious/package.json).

# Developers

- [How Materialious is built](./docs/BUILDING.md)

- [How to contribute to Materialious](./docs/DEV.md)