Materialious：YouTube 隐私前端

项目简介

Materialious 是一个面向 YouTube 与 Invidious 的现代 Material Design 前端，目标是提供干净、注重隐私的观看体验。界面基于 Beer CSS 的 YouTube 模板构建，带有无广告、无追踪、明暗主题和自定义配色等特性。

Invidious 是可选的：即使没有自建 Invidious 实例，也能通过项目自带的 YouTube 后端使用；当 Invidious 加载视频失败时，会回退到本地视频播放。除网页版外，还提供 Windows、macOS、Linux 桌面客户端，以及 Android、Android TV 版本，并支持 PWA。

项目以 AGPL-3.0 许可证开源，主页为 https://materialio.us 。

主要功能

账号与同步

• 可选的内置账号系统：订阅内容端到端加密，支持历史记录与观看进度同步，使用基于 Proof-of-work 的 Captcha。
• 订阅的导入与导出，并可自动与 Invidious / Materialious 互相导入导出。
• 在多个 Invidious 会话之间同步观看进度。

Invidious 与订阅

• Invidious 可选，无实例时可通过自带的 YouTube 后端使用。
• Invidious 加载失败时自动回退到本地视频。
• 支持 Invidious companion，并集成 Invidious 订阅。

第三方集成

• 内置 SponsorBlock。
• 内置 Return YouTube Dislike（RYD）。
• 内置 DeArrow。

播放器

• 章节（Chapters）。
• 迷你播放器（画中画 / PIP）。
• 播放列表。

平台与隐私

• 支持 Android TV。
• 允许关闭证书校验，方便 homelab 用户使用自签证书。
• 无广告、无追踪。
• 明 / 暗主题与自定义配色主题。
• PWA 支持、YT 路径重定向。

安装与使用

Docker 部署

功能完整、带可选账号系统、配置更简单的版本，部署方式参见 DOCKER-FULL 指南。

纯 Invidious 前端的旧版部署方式仍被完全支持，但部署相对麻烦，参见 DOCKER 指南。

安装为应用

• Windows：下载 Materialious-win32-x64.exe。
• macOS（x64 & arm64）：下载 Materialious-darwin-universal.dmg。
• Android：可从 GitHub Releases 下载 APK，或通过 Obtainium、F-Droid、IzzyOnDroid 获取。
• Android TV：请使用 APKUpdater。
• Flatpak：

flatpak install flathub us.materialio.Materialious

• AppImage：下载 Materialious-linux-x86_64.AppImage。
• Debian / Ubuntu：下载 .deb 包 后执行：

sudo apt install ./Materialious-linux-amd64.deb

• Fedora / OpenSuse：下载 .rpm 包 后执行：

# Fedora
sudo dnf install ./Materialious-linux-x86_64.rpm
# OpenSuse
sudo zypper in ./Materialious-linux-x86_64.rpm

• Linux（tarball）：下载 Materialious-linux-x64.7z。

注意事项

• Invidious 并非必需；不部署 Invidious 时依赖项目自带的 YouTube 后端。
• 内置账号系统是可选项，不注册也能直接观看。
• 关闭证书校验的选项主要面向 homelab / 自托管用户，请自行评估安全影响。
• 多端界面均支持明暗主题与自定义配色，Android 端额外适配 Android TV 的大屏与遥控器操作。
• 想参与界面翻译，可通过 Weblate 提交。
• 项目采用 GNU Affero General Public License v3.0（AGPL-3.0）许可证。

本作品整理自 GitHub 开源项目 Materialious/Materialious，原作者 @Materialious，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。