Back to Details

cli-anything-quietshrink

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

quietshrink — Agent Skill

quietshrink — Agent Skill

You have access to 
cli-anything-quietshrink
, a CLI for compressing video files on macOS Apple Silicon. It uses the Media Engine (hardware HEVC encoder), not the CPU, so encoding is fast and silent.
你可以使用
cli-anything-quietshrink
，这是一款适用于macOS Apple Silicon的视频压缩CLI工具。它采用Media Engine（硬件HEVC编码器）而非CPU进行编码，因此编码速度快且全程静音。

When to use it

使用场景

  • User wants to compress a screen recording, screencast, or any .mov/.mp4 file
  • File is too large to share (chat, email, GitHub)
  • Need smaller files but cannot tolerate visible quality loss
  • Apple Silicon Mac (M1/M2/M3/M4) — best results
Don't use this on non-screen content (camera footage, vlogs) — savings will be much smaller because there are no duplicate frames to drop.
  • 用户需要压缩屏幕录制文件、截屏视频或任何.mov/.mp4格式的文件
  • 文件过大无法分享（聊天、邮件、GitHub）
  • 需要更小的文件但无法接受可见的画质损失
  • Apple Silicon Mac（M1/M2/M3/M4）——效果最佳
请勿将其用于非屏幕内容（相机拍摄的视频、博客视频）——这类文件可压缩的空间很小，因为没有可丢弃的重复帧。

Commands

命令

bash
undefined
bash
undefined

Compress with default transparent quality

使用默认的视觉无损画质进行压缩

cli-anything-quietshrink compress <input> [output]
cli-anything-quietshrink compress <input> [output]

Compress with specific preset

使用特定预设进行压缩

cli-anything-quietshrink compress -q tiny <input> # smallest cli-anything-quietshrink compress -q transparent <input> # default, visually lossless cli-anything-quietshrink compress -q pristine <input> # near-source quality
cli-anything-quietshrink compress -q tiny <input> # 文件最小 cli-anything-quietshrink compress -q transparent <input> # 默认选项，视觉无损 cli-anything-quietshrink compress -q pristine <input> # 接近源文件画质

Inspect a file before compressing

压缩前检查文件信息

cli-anything-quietshrink probe <input>
cli-anything-quietshrink probe <input>

List quality presets

列出画质预设

cli-anything-quietshrink presets
cli-anything-quietshrink presets

Verify environment

验证环境

cli-anything-quietshrink doctor

All commands accept `--json` for machine-readable output.
cli-anything-quietshrink doctor

所有命令都支持`--json`参数以输出机器可读格式的结果。

Quality presets

画质预设

PresetqTypical reductionSSIMUse case
tiny
50~90%~0.95Chat/email — small artifacts OK
balanced
55~88%~0.99Docs/sharing — high quality
transparent
(default)		60~87%~0.99+Anything important — visually lossless
pristine
70~84%~0.997Archival — near-source
预设q值典型压缩率SSIM使用场景
tiny
50~90%~0.95聊天/邮件 —— 允许轻微画质损失
balanced
55~88%~0.99文档/分享 —— 高画质
transparent
（默认）		60~87%~0.99+重要内容 —— 视觉无损
pristine
70~84%~0.997存档/编辑 —— 接近源文件

JSON output schema

JSON输出格式

compress
returns:
json
{
  "input": "/path/to/input.mov",
  "output": "/path/to/output.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
returns:
json
{
  "path": "...",
  "size_bytes": 105952129,
  "size_mb": 101.04,
  "codec": "h264",
  "width": 3024,
  "height": 1964,
  "framerate": "120/1",
  "duration_seconds": 193.31
}
compress
命令返回：
json
{
  "input": "/path/to/input.mov",
  "output": "/path/to/output.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
命令返回：
json
{
  "path": "...",
  "size_bytes": 105952129,
  "size_mb": 101.04,
  "codec": "h264",
  "width": 3024,
  "height": 1964,
  "framerate": "120/1",
  "duration_seconds": 193.31
}

Decision flow for agents

Agent决策流程

User wants to share a recording
  ├─ Is it on Apple Silicon Mac? → use quietshrink
  │  ├─ For chat/email/quick share → -q tiny
  │  ├─ For docs/important sharing → -q transparent (default)
  │  └─ For archival/editing → -q pristine
  └─ Not on Mac? → falls back to software, less efficient
Before processing, run 
doctor
to verify environment. For unfamiliar files, run 
probe
to understand resolution/codec/duration.
用户想要分享录制文件
  ├─ 是否在Apple Silicon Mac上？ → 使用quietshrink
  │  ├─ 用于聊天/邮件/快速分享 → -q tiny
  │  ├─ 用于文档/重要内容分享 → -q transparent（默认）
  │  └─ 用于存档/编辑 → -q pristine
  └─ 不在Mac上？ → 回退到软件编码，效率较低
处理前，运行
doctor
命令验证环境。 对于不熟悉的文件，运行
probe
命令了解分辨率/编码格式/时长。

Errors and recovery

错误与恢复

  • ffmpeg not found
    → 
    brew install ffmpeg
  • hevc_videotoolbox not available
    → 
    brew reinstall ffmpeg
  • compression_failed
    → check input file isn't corrupted; try 
    --verbose
    mode to see ffmpeg errors
  • ffmpeg not found
    → 执行
    brew install ffmpeg
    安装
  • hevc_videotoolbox not available
    → 执行
    brew reinstall ffmpeg
    重新安装
  • compression_failed
    → 检查输入文件是否损坏；尝试
    --verbose
    模式查看ffmpeg错误信息

Source

来源