Piped

Front-end YouTube libre et performant conçu pour être fédéré via le Fediverse (ActivityPub).

Description

Piped est un front-end alternatif pour YouTube développé en Java avec Spring Boot. Comme [[app-invidious]], il sert d'intermédiaire entre l'utilisateur et les serveurs de Google, mais il se distingue par sa capacité à être fédéré : chaque instance peut suivre et être suivie par d'autres instances Piped via le protocole ActivityPub, ce qui permet de créer un véritable réseau social autour des vidéos YouTube.

L'interface est moderne, supportant les playlists, les abonnements, l'historique, les shorts, les chapitres, les sous-titres et le mode SponsorBlock intégré pour skipper les introductions, outros et segments sponsorisés. Piped supporte également le streaming via proxy (audio uniquement) et le téléchargement direct en plusieurs formats.

L'écosystème Piped repose sur trois composants : le back-end (Spring Boot), le front-end (Vue.js) et un module optionnel d'indexation ([[app-piped-search]]) qui fournit des résultats de recherche complets sans dépendre de l'API YouTube. Une instance auto-hébergée peut être utilisée seule ou en réseau fédéré.

Installation

Via Docker (recommandé)

services:
  piped-backend:
    image: 1337kevin/piped-piped:latest
    container_name: piped-backend
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      HOST: 0.0.0.0
      PORT: 8080
      PROXY_PARTNERS: "false"
      DISABLE_LOCAL_SEARCH: "true"
      DISABLE_TORRENT_FILES: "false"

  piped-frontend:
    image: 1337kevin/piped-frontend:latest
    container_name: piped-frontend
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      VITE_API_URL: https://piped.example.com/api
      VITE_USE_HTTPS: "true"
    depends_on:
      - piped-backend

Installation manuelle

Le back-end nécessite Java 17 et Maven. Cloner le dépôt, exécuter mvn package puis lancer le jar. Le front-end requiert Node 18+ et pnpm. Pour le développement, configurer nuxt.config.ts avec l'URL du back-end.

Configuration

La configuration se fait par variables d'environnement. Les options principales sont : PROXY_PARTNERS (activer le proxy des partenaires YouTube), DISABLE_LOCAL_SEARCH (utiliser un index externe), CORS origins autorisées, et le nombre maximum de streams concurrents. Le front-end utilise VITE_API_URL pour pointer vers le back-end.

Alternatives

Open source

• [[app-invidious]] — Front-end YouTube en Crystal, plus léger
• [[app-beatbump]] — Front-end YouTube Music en Svelte
• [[app-materialious]] — Front-end YouTube avec UI Material You
• [[app-redlib]] — Front-end Reddit, même philosophie libératrice

Propriétaires

• YouTube — Plateforme officielle avec tracking
• Hooktube (déprécié) — Ancien projet du même esprit

Sécurité

• Mettre en place un rate-limiter sur le back-end (Cloudflare ou [[app-fail2ban]])
• Activer HTTPS strict avec HSTS
• Isoler le composant d'indexation dans un réseau Docker privé
• Surveiller l'usage de bande passante : Piped consomme du fait du proxy vidéo
• Restreindre /api/v1/auth/register si l'inscription est ouverte

Ressources

• Site officiel : https://piped.video
• Code source : https://github.com/TeamPiped/Piped
• Documentation : https://docs.piped.video
• API : https://piped-api-docs.ducks.party