cli-anything-quietshrink

quietshrink — Habilidade para Agentes

Você tem acesso a cli-anything-quietshrink, uma CLI para comprimir arquivos de vídeo no macOS com Apple Silicon. Ela usa o Media Engine (codificador HEVC por hardware), não a CPU, então a codificação é rápida e silenciosa.

Quando usar

• O usuário deseja comprimir uma gravação de tela, screencast ou qualquer arquivo .mov/.mp4
• O arquivo é muito grande para compartilhar (chat, e-mail, GitHub)
• Precisa de arquivos menores, mas sem perda visível de qualidade
• Mac com Apple Silicon (M1/M2/M3/M4) — melhores resultados

Não use isso em conteúdo que não seja de tela (filmagens de câmera, vlogs) — a economia será muito menor porque não há quadros duplicados para descartar.

Comandos

# Comprimir com qualidade padrão transparente
cli-anything-quietshrink compress <entrada> [saída]

# Comprimir com preset específico
cli-anything-quietshrink compress -q tiny <entrada>     # menor tamanho
cli-anything-quietshrink compress -q transparent <entrada>  # padrão, visualmente sem perdas
cli-anything-quietshrink compress -q pristine <entrada>     # qualidade próxima à original

# Inspecionar um arquivo antes de comprimir
cli-anything-quietshrink probe <entrada>

# Listar presets de qualidade
cli-anything-quietshrink presets

# Verificar ambiente
cli-anything-quietshrink doctor

Todos os comandos aceitam --json para saída legível por máquina.

Presets de qualidade

Preset	q	Redução típica	SSIM	Caso de uso
tiny	50	~90%	~0.95	Chat/e-mail — artefatos pequenos são aceitáveis
balanced	55	~88%	~0.99	Documentos/compartilhamento — alta qualidade
transparent (padrão)	60	~87%	~0.99+	Qualquer coisa importante — visualmente sem perdas
pristine	70	~84%	~0.997	Arquivamento — qualidade próxima à original

Esquema de saída JSON

compress retorna:

{
  "input": "/caminho/para/entrada.mov",
  "output": "/caminho/para/saida.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 retorna:

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

Fluxo de decisão para agentes

Usuário quer compartilhar uma gravação
  ├─ É um Mac com Apple Silicon? → usar quietshrink
  │  ├─ Para chat/e-mail/compartilhamento rápido → -q tiny
  │  ├─ Para documentos/compartilhamento importante → -q transparent (padrão)
  │  └─ Para arquivamento/edição → -q pristine
  └─ Não é Mac? → fallback para software, menos eficiente

Antes de processar, execute doctor para verificar o ambiente. Para arquivos desconhecidos, execute probe para entender resolução/codec/duração.

Erros e recuperação

• ffmpeg not found → brew install ffmpeg
• hevc_videotoolbox not available → brew reinstall ffmpeg
• compression_failed → verificar se o arquivo de entrada não está corrompido; tente o modo --verbose para ver erros do ffmpeg

Origem

• Repositório principal: https://github.com/achiya-automation/quietshrink
• CLI Bash: comando quietshrink (via script de instalação)
• Por que essa abordagem funciona: veja WHY.md