Skip to content

Video Commands (owl video)

Tools for processing and analyzing MKV video files from OWA recordings.

FFmpeg Required

Video commands require FFmpeg to be installed and available in your system PATH.

Command Reference

owl video

Video processing commands.

Usage:

owl video [OPTIONS] COMMAND [ARGS]...
owl video probe

Analyze frame types and patterns in a video file

Usage:

owl video probe [OPTIONS] {video_path}
owl video transcode

Transcode video files with professional encoding settings.

Options: fps: Target frame rate (forces constant frame rate output) width/height: Target resolution in pixels (maintains aspect ratio if only one specified) codec: Video codec (libx264 for H.264, libx265 for H.265) crf: Quality level (0-51, lower=better quality, 18=high, 23=default, 28=smaller file) keyint: Keyframe interval/GOP size (lower=better seeking, higher=better compression) min-keyint: Minimum keyframe interval (optional, for fine control) scenecut: Scene change detection (0=disable for consistent GOP [default], 40=adaptive) dry-run: Show command without executing

Examples: # Basic transcoding owa video transcode input.mkv output.mkv

# Custom resolution and frame rate
owa video transcode input.mkv output.mkv --fps 30 --width 1920 --height 1080

# High quality encoding for archival
owa video transcode input.mkv output.mkv --crf 18 --keyint 60 --scenecut 0

# Streaming-optimized (consistent keyframes)
owa video transcode input.mkv output.mkv --keyint 30 --scenecut 0

# Preview command without execution
owa video transcode input.mkv output.mkv --dry-run

Usage:

owl video transcode [OPTIONS] {input_path} {output_path}
owl video vfr-to-cfr

Convert MKV files with Variable Frame Rate (VFR) to Constant Frame Rate (CFR).

Usage:

owl video vfr-to-cfr [OPTIONS] {path}