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: about 2 months 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 (10 months ago)
• Default Branch: main
• Last Pushed: 2024-10-29T08:45:13.000Z (about 2 months ago)
• Last Synced: 2024-10-29T09:56:52.367Z (about 2 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

        


  

  

  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!

- Mini player.

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

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

The latest release can be downloaded [here](https://github.com/Materialious/Materialious/releases/latest).

# Android

Due to Google's policies on custom YouTube frontends, Materialious isn't available on Google play. The best way to install is via the [release page](https://github.com/Materialious/Materialious/releases/latest). It is recommended to use [Obtainium](https://github.com/ImranR98/Obtainium), to keep Materialious up to date.

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

## Mini player

![Preview of mini player](./previews/mini-player-desktop-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

- [Invidious](https://github.com/iv-org)

- [Clipious](https://github.com/lamarios/clipious) for inspiration & a good source for learning more about undocumented Invidious routes.

- [Vidstack player](https://github.com/vidstack/player)

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