---
title: Piped
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, front-end, youtube, video, fediverse]
confidence: high
contested: false
sources: [https://selfh.st/apps/?q=piped]
---

# Piped

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

| Métadonnée | Valeur |
| :--- | :--- |
| **Site web** | https://piped.video |
| **GitHub** | https://github.com/TeamPiped/Piped |
| **License** | AGPL-3.0 |
| **Langage principal** | Java (Spring Boot) |
| **Étoiles GitHub** | 857 |
| **Dernière MAJ** | 2026 |
| **Catégorie** | [[cat-front-end]] |

## 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é)
```yaml
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

## Pages Liées
- [[cat-front-end]]
- [[recettes-docker-compose]]
