Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,82 @@
+---
+title: Materialious
+created: 2026-06-07
+updated: 2026-06-07
+type: app
+tags: [catalogue, front-end, youtube, material, svelte]
+confidence: medium
+contested: false
+sources: [https://selfh.st/apps/?q=materialious]
+---
+
+# Materialious
+
+> Front-end YouTube moderne avec interface Material You 3, compatible avec Invidious et Piped.
+
+| Métadonnée | Valeur |
+| :--- | :--- |
+| **Site web** | https://materialious.telebyte.cloud |
+| **GitHub** | https://github.com/WardPearce/Materialious |
+| **License** | AGPL-3.0 |
+| **Langage principal** | SvelteKit (TypeScript) |
+| **Étoiles GitHub** | 60 |
+| **Dernière MAJ** | 2026 |
+| **Catégorie** | [[cat-front-end]] |
+
+## Description
+Materialious est un front-end YouTube qui se distingue par son interface inspirée de **Material You 3**, le système de design dynamique de Google/Android 14+. C'est un "méta-front-end" : il peut fonctionner comme un client autonome en appelant directement l'API YouTube, ou se connecter à une instance existante de [[app-invidious]] ou [[app-piped]] pour bénéficier de leur anonymisation.
+
+L'interface propose un système de thèmes dynamiques (couleurs dérivées de l'artwork de la vidéo), un mini-lecteur flottant (Picture-in-Picture), le support de **SponsorBlock** intégré, le téléchargement de vidéos, les playlists, les sous-titres, les chapitres, et un mode "Commentaires désactivés par défaut" pour réduire la toxicité.
+
+L'authentification est entièrement locale (comptes en IndexedDB) avec chiffrement AES-GCM côté client. Materialious peut être installé comme PWA sur mobile, supporte le mode hors-ligne pour le contenu déjà visionné, et dispose d'un client **MPV** intégré pour le visionnage desktop avec décodage matériel.
+
+## Installation
+### Via Docker (recommandé)
+```yaml
+services:
+  materialious:
+    image: ghcr.io/wardpearce/materialious:latest
+    container_name: materialious
+    restart: unless-stopped
+    ports:
+      - "3001:3001"
+    environment:
+      PUBLIC_API_URL: https://invidious.example.com/api/v1
+      PUBLIC_INSTANCE_TYPE: invidious
+      ORIGIN: https://materialious.example.com
+```
+
+### Installation manuelle
+Cloner le dépôt, `pnpm install`, `pnpm build`. Servir le dossier `build/` via un serveur statique (Caddy, Nginx) configuré pour le SSR SvelteKit. Node 18+ et pnpm 8+ requis.
+
+## Configuration
+Les options principales sont définies au build via variables d'environnement : `PUBLIC_API_URL` (URL de l'instance Invidious/Piped), `PUBLIC_INSTANCE_TYPE` (`invidious` ou `piped`), `PUBLIC_SPONSORBLOCK_URL` (instance SponsorBlock, par défaut sponsor.ajay.app). Le mode autonome utilise l'API YouTube non-officielle via le proxy Piper.
+
+## Alternatives
+### Open source
+- [[app-invidious]] — Front-end YouTube historique
+- [[app-piped]] — Front-end YouTube en Java
+- [[app-beatbump]] — Variante pour YouTube Music
+- [[app-freetube]] — Client desktop Electron
+
+### Propriétaires
+- YouTube — Plateforme officielle
+- YouTube Vanced (déprécié) — Client Android modifié
+- ReVanced — Projet open source de patching, équivalent moderne
+
+## Sécurité
+- Préférer une instance auto-hébergée d'Invidious/Piped pour ne pas exposer ses habitudes de visionnage
+- Activer HTTPS strict sur l'instance Materialious
+- Chiffrer la base IndexedDB locale (le mot de passe est stocké sous forme chiffrée, mais choisir un mot de passe fort)
+- Mettre à jour régulièrement pour suivre les changements d'API
+- Activer le mode privé sur le reverse proxy si exposé publiquement
+
+## Ressources
+- Site officiel : https://materialious.telebyte.cloud
+- Code source : https://github.com/WardPearce/Materialious
+- Documentation : https://github.com/WardPearce/Materialious#readme
+- Releases : https://github.com/WardPearce/Materialious/releases
+
+## Pages Liées
+- [[cat-front-end]]
+- [[recettes-docker-compose]]