cli-anything-quietshrink

Apple Silicon 搭載 Mac で画面収録を CPU に負荷をかけずに圧縮します。

cli-anything-quietshrink とは？

quietshrink は、macOS Apple Silicon (M1/M2/M3/M4) 搭載 Mac 向けに設計された、画面収録やスクリーンキャストなどの動画ファイルをハードウェア HEVC エンコーダー (Media Engine) を使用して高速かつ静かに圧縮する CLI ツールです。CPU ではなく専用ハードウェアでエンコードするため、エンコード中も CPU 負荷がほぼゼロで、冷却ファンが回らず静音です。主なユースケースは、チャットやメール、GitHub で共有するためにサイズが大きすぎる .mov / .mp4 ファイルを、目に見える品質劣化を許容しつつ大幅に削減することです。`compress`、`probe`、`presets`、`doctor` の4つのコマンドを提供し、品質プリセット (tiny / balanced / transparent / pristine) を選択可能。デフォルトの `transparent` は視覚的に可逆 (SSIM 0.99+) で、平均 87% の削減率を達成します。非画面収録コンテンツ (カメラ映像、vlog など) では重複フレームが少ないため削減率が小さくなる点に注意が必要です。

対応~Claude Code~Codex CLI~Cursor

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

ドキュメント

quietshrink — エージェントスキル

あなたは 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 <入力> [出力]

# 特定のプリセットで圧縮
cli-anything-quietshrink compress -q tiny <入力>     # 最小
cli-anything-quietshrink compress -q transparent <入力>  # デフォルト、視覚的にロスレス
cli-anything-quietshrink compress -q pristine <入力>     # ソースに近い品質

# 圧縮前にファイルを検査
cli-anything-quietshrink probe <入力>

# 品質プリセットを一覧表示
cli-anything-quietshrink presets

# 環境を確認
cli-anything-quietshrink doctor

すべてのコマンドは --json を受け付け、機械可読な出力を提供します。

品質プリセット

プリセット	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
}

エージェント向け判断フロー

ユーザーが録画を共有したい
  ├─ 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 を参照

cli-anything-quietshrink