Files
wiki/Catalogue-Self-Hosted/apps/app-handbrake-web.md
T
2026-06-09 18:40:21 +02:00

3.7 KiB


title: HandBrake Web created: 2026-06-08 updated: 2026-06-08 type: app tags: [catalogue, file-conversion, video, transcoding, app-marathon-batch-rattrapage-3] confidence: high contested: false sources: [https://selfh.st/apps/?tag=File+Conversion, https://handbrake.fr]

🔄 HandBrake Web

Transcodage vidéo self-hosted : interface web pour le célèbre HandBrake, encodage H.264/H.265/AV1 par lot depuis le navigateur.

📋 Informations Génériques

Champ Valeur
Site web handbrake.fr (CLI)
GitHub TheNickOfTime/handbrake-web
License MIT
Langage TypeScript (wrapper sur HandBrake CLI)
Étoiles GitHub 1.5k (web wrapper)
Catégorie [[cat-file-conversion

📝 Description

HandBrake Web est une interface web pour le célèbre HandBrake CLI (encodeur vidéo open source de référence). Encodage H.264, H.265, VP9, AV1, avec presets pour Apple/Android/Roku/PS, support des sous-titres, filtres, et traitement par lot depuis une UI web accessible à toute la famille.

Différence avec ConvertX : ConvertX convertit entre de nombreux formats (images, documents, audio, vidéo, archives) — un "Swiss Army knife". HandBrake Web est spécialisé vidéo mais fait le transcodage bien plus finement (deux passes, CRF, filtres déinterlace, etc.).

Différence avec FileFlows : FileFlows est un pipeline (scan folder, watch, post-processing, règles) ; HandBrake Web est un outil one-shot / batch plus simple.

Pour qui : archivistes vidéo, familles, homelabbers qui rippent/convertissent des vidéos occasionnellement.

🚀 Installation

Docker Compose (recommandé)

version: '3.8'
services:
  handbrake-web:
    image: thedarklord/handbrake-web:latest
    container_name: handbrake-web
    restart: unless-stopped
    ports:
      - "8088:8080"
    environment:
      - HANDBRAKE_PATH=/usr/bin/HandBrakeCLI
      - WATCH_ENABLED=true
      - WATCH_DIR=/watch
    volumes:
      - handbrake-config:/config
      - /chemin/vers/films:/watch:ro
      - /chemin/vers/output:/output
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.handbrake.rule=Host(`encode.example.com`)"
      - "traefik.http.routers.handbrake.entrypoints=websecure"
      - "traefik.http.routers.handbrake.tls.certresolver=letsencrypt"
      - "traefik.http.routers.handbrake.middlewares=authelia@docker"

volumes:
  handbrake-config:

🔄 Alternatives

Open Source

Propriétaires

  • HandBrake desktop — Même CLI, UI native (pas serveur)
  • XMedia Recode — Windows seulement

🔐 Sécurité

  • GPU passthrough : --gpus all + /dev/dri:/dev/dri pour NVENC/QSV, accélération x10-x20.
  • Watch folder : monter en :ro pour éviter l'exécution sur fichier arbitraire.
  • Auth obligatoire : HandBrake Web a une UI admin — protéger par Authelia/Authentik en exposition publique.
  • Pas de sandboxing : HandBrake exploite des CVE sur les codecs — limiter l'input à des sources de confiance.

📚 Ressources

Pages Liées