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 with fps/resolution/quality control.

This command maintains all video, audio, and subtitle streams while applying professional encoding settings for maximum compatibility.

Key Parameters: - fps: Target frame rate (default: 60) - higher fps for smooth motion - keyint: Keyframe interval (default: 30) - lower = better seeking, higher = better compression - scenecut: Scene change detection (0=disable for consistent GOP, 40=default adaptive) - crf: Quality level (18=high, 23=default, 28=lower) - lower numbers = better quality

Examples: # Basic transcoding with defaults (60fps, keyint=30) owl video transcode input.mkv output.mkv

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

# High quality with fixed keyframes (good for streaming) owl video transcode input.mkv output.mkv --crf 18 --keyint 60 --scenecut 0

# Screen recording optimization owl video transcode input.mkv output.mkv --fps 30 --keyint 30 --scenecut 0

Usage:

owl video transcode [OPTIONS] INPUT_PATH OUTPUT_PATH

Options:

Name Type Description Default
--fps, -f float Target FPS 60.0
--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) None
--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