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]...

Options:

Name Type Description Default
--install-completion boolean Install completion for the current shell. None
--show-completion boolean Show completion for the current shell, to copy it or customize the installation. None
--help boolean Show this message and exit. False
owl video probe

Analyze frame types and patterns in a video file

Usage:

owl video probe [OPTIONS] VIDEO_PATH

Options:

Name Type Description Default
--detailed, -d boolean Show detailed frame information False
--frames, -f boolean Show intervals in frames instead of seconds False
--max-frames, -m integer Maximum frames to show in pattern visualization 200
--max-gops, -g integer Maximum GOPs to analyze in detail 3
--help boolean Show this message and exit. False
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

Options:

Name Type Description Default
--fps, -f float Target FPS None
--width, -w integer Target width None
--height, -h integer Target height None
--codec, -c text Video codec libx264
--crf integer Quality (0-51, lower=better) None
--keyint, -k integer Keyframe interval 30
--min-keyint integer Min keyframe interval None
--scenecut integer Scene cut threshold (0=disable, default: 0) 0
--dry-run boolean Show command only False
--help boolean Show this message and exit. False
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

Options:

Name Type Description Default
--workers, -w integer Maximum number of parallel conversions None
--dry-run boolean Show what would be done without actually converting files False
--help boolean Show this message and exit. False