cli-anything-quietshrink

quietshrink — Compétence Agent

Vous avez accès à cli-anything-quietshrink, un outil CLI pour compresser des fichiers vidéo sur macOS Apple Silicon. Il utilise le moteur multimédia (encodeur HEVC matériel), pas le CPU, donc l'encodage est rapide et silencieux.

Quand l'utiliser

• L'utilisateur veut compresser un enregistrement d'écran, screencast, ou tout fichier .mov/.mp4
• Le fichier est trop volumineux pour être partagé (chat, e-mail, GitHub)
• Besoin de fichiers plus petits sans perte de qualité visible
• Mac Apple Silicon (M1/M2/M3/M4) — meilleurs résultats

N'utilisez pas cet outil sur du contenu non-écran (séquences caméra, vlogs) — les gains seront bien moindres car il n'y a pas de trames en double à supprimer.

Commandes

# Compresser avec la qualité transparente par défaut
cli-anything-quietshrink compress <entrée> [sortie]

# Compresser avec un preset spécifique
cli-anything-quietshrink compress -q tiny <entrée>     # plus petit
cli-anything-quietshrink compress -q transparent <entrée>  # défaut, visuellement sans perte
cli-anything-quietshrink compress -q pristine <entrée>     # qualité quasi source

# Inspecter un fichier avant compression
cli-anything-quietshrink probe <entrée>

# Lister les presets de qualité
cli-anything-quietshrink presets

# Vérifier l'environnement
cli-anything-quietshrink doctor

Toutes les commandes acceptent --json pour une sortie lisible par machine.

Presets de qualité

Preset	q	Réduction typique	SSIM	Cas d'usage
tiny	50	~90 %	~0.95	Chat/e-mail — petits artefacts OK
balanced	55	~88 %	~0.99	Docs/partage — haute qualité
transparent (défaut)	60	~87 %	~0.99+	Tout ce qui est important — visuellement sans perte
pristine	70	~84 %	~0.997	Archivage — quasi source

Schéma de sortie JSON

compress retourne :

{
  "input": "/chemin/vers/entrée.mov",
  "output": "/chemin/vers/sortie.mov",
  "input_size": 105952129,
  "output_size": 12345678,
  "saved_bytes": 93606451,
  "saved_percent": 88.3,
  "duration_seconds": 193.3,
  "elapsed_seconds": 87,
  "encoding_speed": "2.2x",
  "quality_preset": "transparent",
  "q_value": 60,
  "gop": 600
}

probe retourne :

{
  "path": "...",
  "size_bytes": 105952129,
  "size_mb": 101.04,
  "codec": "h264",
  "width": 3024,
  "height": 1964,
  "framerate": "120/1",
  "duration_seconds": 193.31
}

Arbre de décision pour les agents

L'utilisateur veut partager un enregistrement
  ├─ Est-ce sur un Mac Apple Silicon ? → utiliser quietshrink
  │  ├─ Pour chat/e-mail/partage rapide → -q tiny
  │  ├─ Pour documents/partage important → -q transparent (défaut)
  │  └─ Pour archivage/édition → -q pristine
  └─ Pas sur Mac ? → utilisation logicielle, moins efficace

Avant le traitement, exécutez doctor pour vérifier l'environnement. Pour les fichiers inconnus, exécutez probe pour comprendre la résolution/codec/durée.

Erreurs et récupération

• ffmpeg not found → brew install ffmpeg
• hevc_videotoolbox not available → brew reinstall ffmpeg
• compression_failed → vérifiez que le fichier d'entrée n'est pas corrompu ; essayez le mode --verbose pour voir les erreurs ffmpeg

Source

• Dépôt principal : https://github.com/achiya-automation/quietshrink
• CLI Bash : commande quietshrink (via le script d'installation)
• Pourquoi cette approche fonctionne : voir WHY.md