clip

Interactive terminal toolkit for processing Sony camera footage — inspect formats, analyze gyroscope shake, and stabilize videos using Gyroflow.

Features

| Command | Alias | Description | |---------|-------|-------------| | /check-format | /cf | Inspect resolution, fps, codec, color profile, gyro data for every video in a folder | | /detect-stable | /ds | Analyze gyroscope shake intensity with sparkline visualization | | /stabilize | /s | Stabilize videos using Gyroflow, output to a sibling _stable/ directory | | /help | /h | List all available commands | | /quit | /q | Exit |

Requirements

• macOS
• Node.js ≥ 18
• ffmpeg (provides ffprobe) — offered for auto-install on first run
• Gyroflow — offered for auto-install on first run

Both tools are detected automatically at startup. If either is missing, clip will prompt you to install them via Homebrew before continuing.

Install

via npm

npm install -g @haiguai/clip

via Homebrew

brew tap haiguai/clip
brew install clip

Usage

clip

You will see an interactive prompt. Type a command and press Enter, or use Tab to autocomplete.

❯ /check-format

First-run experience

On first launch, clip checks for ffprobe and Gyroflow. If either is missing it walks you through installing them:

⚠ ffprobe not found — required for video inspection
  Install ffmpeg via Homebrew? (provides ffprobe)  [Y/n]  ← press Y

  Installing ffmpeg via Homebrew...
  ✓ ffmpeg installed

⚠ Gyroflow not found — required for stabilization
  Install Gyroflow via Homebrew?  [Y/n]  ← press Y

  Installing Gyroflow via Homebrew...
  ✓ gyroflow installed successfully

❯  ← ready

After the first run, startup is instant.

/check-format

Pick a folder and clip scans every video file recursively, querying ffprobe in parallel. Results are shown as a table:

File              Resolution    FPS    Codec   Audio       Color     Gyro
────────────────────────────────────────────────────────────────────────
C0001.MP4         3840x2160    59.9   hevc    AAC stereo  SLog3      ✓
C0002.MP4         3840x2160    59.9   hevc    AAC stereo  HLG        ✓

/detect-stable

Pick a folder and clip extracts gyroscope data from each video via Gyroflow, then shows a shake-intensity table with sparkline graphs:

File              Peak°/s    RMS°/s   Shake (25 segments)
────────────────────────────────────────────────────────
C0001.MP4           12.4       4.2    ▂▃▂▁▂▄▃▂▁▂▃▂▁▂▂▃▂▁▂▃▂▁▂▂▃
C0002.MP4           38.1      14.7    ▄▆▇█▆▅▄▆▇█▅▄▆▇█▆▅▄▆▇█▅▄▆▇

/stabilize

1. Enter a smoothness value (default 0.03 — higher = smoother but more crop)
2. Pick a folder
3. clip processes all videos concurrently using Gyroflow
4. Stabilized files are written to a sibling directory: {folder}_stable/

Example: stabilizing ~/Videos/sony/ produces ~/Videos/sony_stable/ with the same subdirectory structure.

License

MIT