Standalone CLI macOS · Windows BaoCut.app optional

Built for terminals and agents

Install BaoCut CLI

Run BaoCut’s transcription, subtitle, translation, timeline, and export engines headlessly with bcut. Install it with npm or Homebrew, or download the verified release archive yourself.

Install with npm Download archive
Version 1.0.8 · build 43 Command: bcut No account required

Choose your installer

The app is not required

Every option installs the same standalone CLI. npm is the simplest choice when Node.js is already available.

Recommended

npm

macOS Apple Silicon and Windows x64 · Node.js 18 or later.

$ npm install --global @baocut/cli
$ bcut --json version
View @baocut/cli on npm
macOS

Homebrew

macOS 15 or later on Apple Silicon. FFmpeg is installed as a dependency.

$ brew install --cask JimLiu/tap/baocut
$ bcut --json version
View the BaoCut tap

Manual macOS installation

Verify, unpack, and link

The archive contains both bcut and mlx.metallib. Keep them together so the MLX backend can load its Metal library.

These commands install into your home directory. Ensure ~/.local/bin is on your PATH.

# Download the current release and checksum
VERSION=1.0.8-build.43
ARCHIVE="bcut-${VERSION}-aarch64-apple-darwin.zip"
BASE="https://github.com/JimLiu/baocut/releases/download/baocut-v${VERSION}"
$ curl -fLO "$BASE/$ARCHIVE"
$ curl -fLO "$BASE/$ARCHIVE.sha256"
$ shasum -a 256 -c "$ARCHIVE.sha256"

# Keep bcut and mlx.metallib in the same versioned directory
$ mkdir -p "$HOME/.local/share/baocut/$VERSION" "$HOME/.local/bin"
$ unzip -q "$ARCHIVE" -d "$HOME/.local/share/baocut/$VERSION"
$ chmod +x "$HOME/.local/share/baocut/$VERSION/bcut"
$ ln -sfn "$HOME/.local/share/baocut/$VERSION/bcut" "$HOME/.local/bin/bcut"
$ bcut --json version
# Transcribe, polish, and translate
$ bcut auto talk.mp4 --lang zh

# Export translated subtitles
$ bcut export talk.bcut --to srt --mode translated --lang zh

# Inspect the machine-readable contract
$ bcut --json spec

Runtime requirements

Bring FFmpeg, download models as needed

  • macOS: macOS 15 or later on Apple Silicon.
  • Windows: x64; the current native binary is an unsigned preview and may trigger SmartScreen or enterprise policy.
  • Media: FFmpeg and FFprobe must be available on PATH for npm and manual installations.
  • Models: speech model weights download only when required; they are not bundled in the package.
Get FFmpeg Agent Skill