quietshrink — Habilidad de Agente
Tienes acceso a cli-anything-quietshrink, una CLI para comprimir archivos de video en macOS con Apple Silicon. Utiliza el Media Engine (codificador HEVC por hardware), no la CPU, por lo que la codificación es rápida y silenciosa.
Cuándo usarlo
- El usuario quiere comprimir una grabación de pantalla, screencast o cualquier archivo .mov/.mp4
- El archivo es demasiado grande para compartir (chat, email, GitHub)
- Se necesitan archivos más pequeños sin pérdida de calidad visible
- Mac con Apple Silicon (M1/M2/M3/M4) — mejores resultados
No uses esto en contenido que no sea de pantalla (grabaciones de cámara, vlogs) — el ahorro será mucho menor porque no hay fotogramas duplicados que eliminar.
Comandos
# Comprimir con calidad transparente predeterminada
cli-anything-quietshrink compress <entrada> [salida]
# Comprimir con un preajuste específico
cli-anything-quietshrink compress -q tiny <entrada> # más pequeño
cli-anything-quietshrink compress -q transparent <entrada> # predeterminado, sin pérdida visual
cli-anything-quietshrink compress -q pristine <entrada> # calidad cercana a la fuente
# Inspeccionar un archivo antes de comprimir
cli-anything-quietshrink probe <entrada>
# Listar preajustes de calidad
cli-anything-quietshrink presets
# Verificar el entorno
cli-anything-quietshrink doctor
Todos los comandos aceptan --json para salida legible por máquina.
Preajustes de calidad
| Preajuste | q | Reducción típica | SSIM | Caso de uso |
|---|---|---|---|---|
tiny | 50 | ~90% | ~0.95 | Chat/email — artefactos pequeños aceptables |
balanced | 55 | ~88% | ~0.99 | Documentos/compartición — alta calidad |
transparent (predeterminado) | 60 | ~87% | ~0.99+ | Cualquier cosa importante — sin pérdida visual |
pristine | 70 | ~84% | ~0.997 | Archivado — cercano a la fuente |
Esquema de salida JSON
compress devuelve:
{
"input": "/ruta/al/archivo.mov",
"output": "/ruta/al/archivo_comprimido.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 devuelve:
{
"path": "...",
"size_bytes": 105952129,
"size_mb": 101.04,
"codec": "h264",
"width": 3024,
"height": 1964,
"framerate": "120/1",
"duration_seconds": 193.31
}
Flujo de decisión para agentes
El usuario quiere compartir una grabación
├─ ¿Está en Mac con Apple Silicon? → usa quietshrink
│ ├─ Para chat/email/compartición rápida → -q tiny
│ ├─ Para documentos/compartición importante → -q transparent (predeterminado)
│ └─ Para archivado/edición → -q pristine
└─ ¿No está en Mac? → recurre a software, menos eficiente
Antes de procesar, ejecuta doctor para verificar el entorno.
Para archivos desconocidos, ejecuta probe para entender resolución/códec/duración.
Errores y recuperación
ffmpeg not found→brew install ffmpeghevc_videotoolbox not available→brew reinstall ffmpegcompression_failed→ verifica que el archivo de entrada no esté corrupto; prueba el modo--verbosepara ver errores de ffmpeg
Fuente
- Repositorio principal: https://github.com/achiya-automation/quietshrink
- CLI Bash: comando
quietshrink(a través del script de instalación) - Por qué este enfoque funciona: consulta WHY.md