world-game/docs/ffmpeg.md

# Commandes FFmpeg

## Qu'est-ce que FFmpeg ?

FFmpeg est un outil en ligne de commande open source pour traiter des fichiers audio et vidéo : conversion de formats, compression, extraction de frames, redimensionnement, etc. C'est la référence dans le domaine, utilisée par VLC, YouTube et la plupart des plateformes vidéo en coulisses.

### Installation

**macOS** (via Homebrew) :
```bash
brew install ffmpeg
```

**Linux (Debian/Ubuntu)** :
```bash
sudo apt install ffmpeg
```

**Windows** : télécharger le build depuis [ffmpeg.org/download.html](https://ffmpeg.org/download.html) et ajouter le dossier `bin/` au PATH.

Vérifier l'installation :
```bash
ffmpeg -version
```

---

## Compression vidéo (page d'accueil)

Compresse sans perte de résolution ni de framerate. CRF 23 = qualité par défaut libx264. `faststart` place l'atome `moov` en tête du fichier pour un démarrage immédiat en streaming.

```bash
# Desktop (1920x1080, 30fps) — 22MB → 5.8MB
ffmpeg -i Website_version.mp4 \
  -c:v libx264 -preset slow -crf 23 -an -movflags +faststart \
  Website_version_opt.mp4

# Mobile (1080x1920, 30fps) — 22MB → 4.8MB
ffmpeg -i mobile_version_texte_fixe.mp4 \
  -c:v libx264 -preset slow -crf 23 -an -movflags +faststart \
  mobile_version_opt.mp4
```

## Notes

-   `-an` : supprime la piste audio (inutile pour des vidéos `muted` en fond)
-   `-preset slow` : meilleure compression à qualité égale (encode plus lentement)
-   `crf` : Constant Rate Factor — plus bas = meilleure qualité. 23 = défaut libx264, 18 = quasi-lossless