mcpField
C
cli-anything-quietshrink

cli-anything-quietshrink

github.com/hkudsクリエイティブ・メディア57.6k395 回インストール5 週間前に更新
リポジトリ

cli-anything-quietshrink について

macOS で動画を圧縮する CLI スキルで、特に画面録画を対象としています。Apple Silicon のハードウェア HEVC エンコードを使い、品質プリセットと機械可読な結果を提供します。

主な機能

  1. 01品質プリセットによる動画圧縮
  2. 02Apple Silicon のハードウェア HEVC エンコード
  3. 03自動化向け JSON 出力
  4. 04ファイルの調査と環境チェック

活用シーン

  1. 01共有用の画面録画の圧縮
  2. 02ドキュメント用の圧縮品質の選択
  3. 03元に近い品質でのアーカイブ作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-quietshrink

インストール後、Claude Code で/cli-anything-quietshrinkを入力して読み込まれたか確認します。

詳細

quietshrink — エージェントスキル

macOS Apple Silicon 上で動画ファイルを圧縮するための CLI、cli-anything-quietshrink を利用できます。CPU ではなく Media Engine(ハードウェア HEVC エンコーダー)を使用するため、エンコードは高速かつ静音です。

使用すべき場面

  • ユーザーが画面収録、スクリーンキャスト、または任意の .mov/.mp4 ファイルを圧縮したい場合
  • ファイルが大きすぎて共有できない場合(チャット、メール、GitHub)
  • より小さいファイルが必要だが、目に見える品質劣化は許容できない場合
  • Apple Silicon Mac(M1/M2/M3/M4)— 最良の結果が得られます

使用しないでください: 画面以外のコンテンツ(カメラ映像、vlog)には使用しないでください。削除できる重複フレームが存在しないため、削減量ははるかに小さくなります。

コマンド

# Compress with default transparent quality
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

# Inspect a file before compressing
cli-anything-quietshrink probe <input>

# List quality presets
cli-anything-quietshrink presets

# Verify environment
cli-anything-quietshrink doctor

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

品質プリセット

プリセットq一般的な削減率SSIM用途
tiny50~90%~0.95チャット/メール — 小さなアーティファクトは許容
balanced55~88%~0.99ドキュメント/共有 — 高品質
transparent(デフォルト)60~87%~0.99+重要なものすべて — 視覚的にロスレス
pristine70~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
}

エージェント向けの意思決定フロー

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

処理の前に、doctor を実行して環境を検証してください。 慣れないファイルについては、probe を実行して解像度/コーデック/長さを把握してください。

エラーと復旧

  • ffmpeg not found → brew install ffmpeg
  • hevc_videotoolbox not available → brew reinstall ffmpeg
  • compression_failed → 入力ファイルが破損していないか確認してください。--verbose モードを試して ffmpeg のエラーを確認してください

ソース

コメント

Markdown 対応