{"id":38555167,"url":"https://github.com/materialious/materialious","last_synced_at":"2026-03-14T01:51:35.797Z","repository":{"id":226412921,"uuid":"768431601","full_name":"Materialious/Materialious","owner":"Materialious","description":"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.","archived":false,"fork":false,"pushed_at":"2026-02-05T14:29:35.000Z","size":132743,"stargazers_count":888,"open_issues_count":30,"forks_count":45,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-02-06T00:58:00.099Z","etag":null,"topics":["3rd-party","android","app","client","custom","frontend","interface","invidious","linux","macos","material","privacy","self-host","smarttv","theme","tv","unraid","windows","youtube"],"latest_commit_sha":null,"homepage":"https://materialio.us","language":"Svelte","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Materialious.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"WardPearce"}},"created_at":"2024-03-07T04:19:48.000Z","updated_at":"2026-02-05T18:06:59.000Z","dependencies_parsed_at":"2025-04-25T14:37:44.196Z","dependency_job_id":"e0134ac8-9778-4f31-b55e-de42d65c4032","html_url":"https://github.com/Materialious/Materialious","commit_stats":null,"previous_names":["wardpearce/materialious","materialious/materialious"],"tags_count":199,"template":false,"template_full_name":null,"purl":"pkg:github/Materialious/Materialious","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Materialious%2FMaterialious","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Materialious%2FMaterialious/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Materialious%2FMaterialious/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Materialious%2FMaterialious/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Materialious","download_url":"https://codeload.github.com/Materialious/Materialious/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Materialious%2FMaterialious/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29186039,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T03:35:06.566Z","status":"ssl_error","status_checked_at":"2026-02-07T03:34:57.604Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3rd-party","android","app","client","custom","frontend","interface","invidious","linux","macos","material","privacy","self-host","smarttv","theme","tv","unraid","windows","youtube"],"created_at":"2026-01-17T07:41:36.528Z","updated_at":"2026-03-03T09:09:10.692Z","avatar_url":"https://github.com/Materialious.png","language":"Svelte","readme":"\u003cdiv align=\"center\"\u003e  \u003cimg src=\"./materialious/static/logo.svg\" width=\"200px\" /\u003e\n  \u003cbr /\u003e\n  \u003cbr /\u003e\n  \u003ch1\u003eMaterialious\u003c/h1\u003e\n  \u003cquote\u003e\n    Modern material design for YouTube and Invidious.\n  \u003c/quote\u003e\n\u003c/div\u003e\n\n\u0026nbsp;\n\n-------\n\n\n![Preview of homepage](./previews/home-preview.png)\n\n\n# Features\n- Internal account system (Optional).\n  * Subscriptions are end-to-end encrypted.\n  * History \u0026 watch progress syncing.\n  * [Proof-of-work Captcha](https://github.com/altcha-org/altcha).\n- Subscription importing/exporting\n  * Automatically import/export Invidious/Materialious.\n- Invidious is optional.\n  * Enjoy Materialious without a Invidious instance via our YouTube backend.\n  * Local video fallback if Invidious fails loading videos.\n- Invidious companion support.\n- Android TV support.\n- Support for disabling certificate validation for homelab users.\n- Sync your watch progress between Invidious sessions.\n- Sponsorblock built-in.\n- [Return YouTube Dislike](https://github.com/Anarios/return-youtube-dislike) (RYD) built-in.\n- [DeArrow](https://github.com/ajayyy/DeArrow) built-in.\n- No ads.\n- No tracking.\n- Light/Dark themes.\n- Custom colour themes.\n- Integrates with Invidious subscriptions.\n- Live stream support.\n- Dash support.\n- Chapters.\n- Mini player (PIP.)\n- Playlists.\n- PWA support.\n- YT path redirects.\n\n# Docker deployment\nThis version of Materialious is feature rich, has its own account system (optional) \u0026 is easier to setup.\n\n[Please read the guide here](./docs/DOCKER-FULL.md)\n\n# Legacy Docker deployment, Invidious only.\nThis 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...\n\n[Please read the guide here](./docs/DOCKER.md)\n\n# Installing as a app\n\u003c!--This layout is taken from spotube's README as I really liked its layout.\nI've commented out places what aren't relevant but might be in the future.--\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth\u003ePlatform\u003c/th\u003e\n    \u003cth\u003ePackage/Installation Method\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eWindows\u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://github.com/Materialious/Materialious/releases/latest/download/Materialious-win32-x64.exe\"\u003e\n        \u003cimg width=\"220\" alt=\"Windows Download\" src=\"https://get.todoist.help/hc/article_attachments/4403191721234/WindowsButton.svg\"\u003e\n      \u003c/a\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eMacOS (x64 \u0026 arm64)\u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://github.com/Materialious/Materialious/releases/latest/download/Materialious-darwin-universal.dmg\"\u003e\n        \u003cimg width=\"220\" alt=\"MacOS Download\" src=\"https://www.filesdna.com/wp-content/uploads/2021/03/mac-download-button-1.png\"\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eAndroid\u003c/td\u003e\n    \u003ctd\u003e\n      \u003cbr\u003e\n      \u003ca href=\"https://github.com/Materialious/Materialious/releases/latest/download/app-universal-release-signed.apk\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/NeoApplications/Neo-Backup/034b226cea5c1b30eb4f6a6f313e4dadcbb0ece4/badge_github.png\" alt=\"Get it on GitHub\" height=\"80\"/\u003e\n      \u003c/a\u003e\n      \u003c/br\u003e\n      \u003cbr\u003e\n        \u003ca href=\"http://apps.obtainium.imranr.dev/redirect.html?r=obtainium://add/https://github.com/Materialious/Materialious\"\u003e\n          \u003cimg height=\"60\" alt=\"Get it on Obtainium\" src=\"https://raw.githubusercontent.com/ImranR98/Obtainium/e3fcf6e0b5187445a76462b4042aba6b2fc15047/assets/graphics/badge_obtainium.png\" /\u003e\n        \u003c/a\u003e\n      \u003c/br\u003e\n      \u003cbr\u003e\n        \u003ca href=\"https://f-droid.org/packages/us.materialio.app/\"\u003e\n          \u003cimg height=\"80\" alt=\"Get it on F-Droid\" src=\"https://fdroid.gitlab.io/artwork/badge/get-it-on.png\" /\u003e\n        \u003c/a\u003e\n      \u003c/br\u003e\n      \u003cbr\u003e\n      \u003ca href=\"https://apt.izzysoft.de/fdroid/index/apk/us.materialio.app\"\u003e\n        \u003cimg height=\"80\" alt=\"Get it on Izzysoft\" src=\"https://codeberg.org/IzzyOnDroid/repo/raw/commit/9873f08e282332a231e64d9729f810f427a521e4/assets/IzzyOnDroid.png\" /\u003e\n      \u003c/a\u003e\n      \u003c/br\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eAndroid TV\u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://github.com/rumboalla/apkupdater\"\u003e\n          For Android TV use APKUpdater.\n      \u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eFlatpak\u003c/td\u003e\n    \u003ctd\u003e\n      \u003cp\u003e\u003ccode\u003eflatpak install flathub us.materialio.Materialious\u003c/code\u003e\u003c/p\u003e\n      \u003ca href=\"https://flathub.org/apps/us.materialio.Materialious\"\u003e\n        \u003cimg width=\"220\" alt=\"Download on Flathub\" src=\"https://flathub.org/assets/badges/flathub-badge-en.png\"\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eAppImage\u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://github.com/Materialious/Materialious/releases/latest/download/Materialious-linux-x86_64.AppImage\"\u003e\n        \u003cimg width=\"220\" alt=\"Download on Flathub\" src=\"https://user-images.githubusercontent.com/61944859/169455015-13385466-8901-48fe-ba90-b62d58b0be64.png\"\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eDebian/Ubuntu\u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://github.com/Materialious/Materialious/releases/latest/download/Materialious-linux-amd64.deb\"\u003e\n        \u003cimg width=\"220\" alt=\"Debian/Ubuntu Download\" src=\"https://user-images.githubusercontent.com/61944859/169097994-e92aff78-fd75-4c93-b6e4-f072a4b5a7ed.png\"\u003e\n      \u003c/a\u003e\n      \u003cp\u003eThen run: \u003ccode\u003esudo apt install ./Materialious-linux-amd64.deb\u003c/code\u003e\u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eFedora/OpenSuse\u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://github.com/Materialious/Materialious/releases/latest/download/Materialious-linux-x86_64.rpm\"\u003e\n        \u003cimg width=\"220\" alt=\"Fedora/OpenSuse Download\" src=\"https://user-images.githubusercontent.com/61944859/223638350-5926b9da-04d6-4edd-931d-ad533e4ff058.png\"\u003e\n      \u003c/a\u003e\n      \u003cp\u003eFor Fedora: \u003ccode\u003esudo dnf install ./Materialious-linux-x86_64.rpm\u003c/code\u003e\u003c/p\u003e\n      \u003cp\u003eFor OpenSuse: \u003ccode\u003esudo zypper in ./Materialious-linux-x86_64.rpm\u003c/code\u003e\u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eLinux (tarball)\u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://github.com/Materialious/Materialious/releases/latest/download/Materialious-linux-x64.7z\"\u003e\n        \u003cimg width=\"220\" alt=\"Tarball Download\" src=\"https://user-images.githubusercontent.com/61944859/169456985-e0ba1fd4-10e8-4cc0-ab94-337acc6e0295.png\"\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n# Translations\n\nHelp [translate Materialious via Weblate](https://toolate.othing.xyz/projects/materialious/)!\n\n\u003ca href=\"https://toolate.othing.xyz/projects/materialious/\"\u003e\n\u003cimg src=\"https://toolate.othing.xyz/widget/materialious/materialious/multi-auto.svg\" alt=\"Translation status\" /\u003e\n\u003c/a\u003e\n\n# Previews\n\n## Mobile\n\u003cimg src=\"./previews/mobile-preview.png\" style=\"height: 500px\"/\u003e\n\n## Android TV Home\n![Preview of subscriptions page on Android TV](./previews/android-tv-home.png)\n\n## Android TV Player\n![Preview of player on Android TV](./previews/android-tv-player.png)\n\n## Login\n![Preview of Login page](./previews/login-previews.png)\n\n## Player\n![Preview of player](./previews/player-preview.png)\n\n## Settings\n![Preview of settings](./previews/setting-preview.png)\n\n## Channel\n![Preview of channel](./previews/channel-preview.png)\n\n## Chapters\n![Preview of chapters](./previews/chapter-previews.png)\n\n## Playlists\n![Preview of playlist page](./previews/playlist-preview.png)\n![Preview of playlist on video page](./previews/playlist-preview-2.png)\n\n# Have any questions?\n[Join our Matrix space](https://matrix.to/#/#ward:matrix.org)\n\n# Special thanks to\n- [SecularSteve](https://github.com/SecularSteve) for creating Materialious' logo.\n- [Invidious](https://github.com/iv-org).\n- [Clipious](https://github.com/lamarios/clipious) for inspiration \u0026 references to undocumented Invidious routes.\n- [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.)\n- [LuanRT](https://github.com/LuanRT) for YouTube.js \u0026 SABR implementation.\n- [FreeTube](https://github.com/FreeTubeApp/FreeTube) for their subtitle fix.\n- [spotube](https://github.com/KRTirtho/spotube) for using their README layout for local installation.\n- Every dependency in [package.json](/materialious/package.json).\n\n# Developers\n- [How Materialious is built](./docs/BUILDING.md)\n- [How to contribute to Materialious](./docs/DEV.md)\n","funding_links":["https://github.com/sponsors/WardPearce"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaterialious%2Fmaterialious","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaterialious%2Fmaterialious","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaterialious%2Fmaterialious/lists"}