quietshrink — Mac屏幕录制视频压缩工具

在Apple Silicon Mac上零CPU压力地压缩屏幕录制视频，使用硬件HEVC编码器实现快速静音压缩。

quietshrink — Mac屏幕录制视频压缩工具是什么？

quietshrink 是一个专为 macOS Apple Silicon 设计的命令行工具，用于高效压缩屏幕录制视频。它利用硬件 HEVC 编码器（Media Engine），而非 CPU，从而实现快速且静音的编码过程——非常适合在共享前减小大型 .mov 或 .mp4 文件。该工具提供多种质量预设（tiny、balanced、transparent、pristine），可根据需求在文件大小和视觉保真度之间取得平衡。支持 `compress`、`probe`、`presets` 和 `doctor` 命令，并可通过 `--json` 标志输出机器可读结果。需要注意的是，此工具最适用于屏幕内容（含大量重复帧），而对普通摄像头视频的提升较小。该工具可集成到 Cursor、Claude Code 等 AI 代理平台中，建议在压缩前运行 `doctor` 验证环境，对于不熟悉的文件先运行 `probe` 进行检查。

兼容平台~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/HKUDS/CLI-Anything/tree/main/skills/cli-anything-quietshrink

文档

quietshrink — Agent 技能

您可以访问 cli-anything-quietshrink，这是一个用于在 macOS Apple Silicon 上压缩视频文件的 CLI 工具。它使用 Media Engine（硬件 HEVC 编码器），而非 CPU，因此编码快速且静音。

何时使用

用户想要压缩屏幕录制、截屏或任何 .mov/.mp4 文件
文件过大，无法分享（聊天、邮件、GitHub）
需要较小的文件，但不能容忍可见的质量损失
Apple Silicon Mac（M1/M2/M3/M4）——效果最佳

不要将此工具用于非屏幕内容（摄像头拍摄的视频、vlog）——因为没有可丢弃的重复帧，压缩率会小得多。

命令

# 使用默认的透明质量进行压缩
cli-anything-quietshrink compress <input> [output]

# 使用特定预设进行压缩
cli-anything-quietshrink compress -q tiny <input>     # 最小化
cli-anything-quietshrink compress -q transparent <input>  # 默认，视觉无损
cli-anything-quietshrink compress -q pristine <input>     # 接近原始质量

# 在压缩前检查文件
cli-anything-quietshrink probe <input>

# 列出质量预设
cli-anything-quietshrink presets

# 验证环境
cli-anything-quietshrink doctor

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

质量预设

Preset	q	典型压缩率	SSIM	使用场景
`tiny`	50	~90%	~0.95	聊天/邮件——可接受少量伪影
`balanced`	55	~88%	~0.99	文档/分享——高质量
`transparent`（默认）	60	~87%	~0.99+	任何重要内容——视觉无损
`pristine`	70	~84%	~0.997	归档——接近原始质量

JSON 输出格式

compress 返回：

{
  "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 返回：

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

Agent 决策流程

用户想要分享录制内容
  ├─ 是否在 Apple Silicon Mac 上？→ 使用 quietshrink
  │  ├─ 用于聊天/邮件/快速分享 → -q tiny
  │  ├─ 用于文档/重要分享 → -q transparent（默认）
  │  └─ 用于归档/编辑 → -q pristine
  └─ 不在 Mac 上？→ 回退到软件编码，效率较低

在处理之前，请运行 doctor 验证环境。对于不熟悉的文件，请运行 probe 了解分辨率、编码器和时长。

错误与恢复

ffmpeg not found → brew install ffmpeg
hevc_videotoolbox not available → brew reinstall ffmpeg
compression_failed → 检查输入文件是否损坏；尝试使用 --verbose 模式查看 ffmpeg 错误信息

来源

主仓库：https://github.com/achiya-automation/quietshrink
Bash CLI：quietshrink 命令（通过安装脚本）
为何此方法有效：参见 WHY.md

quietshrink — Mac屏幕录制视频压缩工具