cli-anything-quietshrink

Apple Silicon 기반 macOS에서 CPU 부하 없이 화면 녹화를 압축합니다.

cli-anything-quietshrink란 무엇인가요?

이 스킬은 macOS Apple Silicon(M1/M2/M3/M4)에서 화면 녹화나 동영상 파일(.mov/.mp4)을 압축할 때 CPU 부하 없이 빠르고 조용하게 처리할 수 있는 CLI 도구입니다. Media Engine의 하드웨어 HEVC 인코더를 활용하므로 CPU를 거의 사용하지 않으며, 인코딩 속도가 빠르고 소음이 없습니다. 품질 사전 설정(tiny, balanced, transparent, pristine)을 통해 용량 감소율과 화질 손실 간 균형을 조절할 수 있으며, 기본값인 transparent는 시각적으로 무손실 수준의 압축을 제공합니다. JSON 출력을 지원하여 AI 에이전트가 결과를 쉽게 파싱할 수 있으며, doctor 명령어로 환경을 확인하고 probe로 파일 정보를 미리 파악할 수 있습니다. 주 사용처는 채팅, 이메일, GitHub 등에 파일을 공유할 때 크기를 줄이는 것이며, 카메라 영상이나 블로그 콘텐츠와 같은 중복 프레임이 적은 영상에는 효율이 낮아 권장되지 않습니다.

지원 대상~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)에서 최상의 결과를 얻을 수 있습니다.

주의: 화면 콘텐츠가 아닌 콘텐츠(카메라 영상, 블로그)에는 사용하지 마세요. 중복 프레임이 없으므로 용량 절감 효과가 훨씬 적습니다.

명령어

# 기본 투명(transparent) 품질로 압축
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