CLI Reference

CLI Reference

Complete list of command-line options for OpenCaptive v1.1.126.

Usage

opencaptive [options]

General

Option	Description
--help, -h	Show help and exit
--version, -v	Show version and exit
--data <path>	Set game data directory
--game captive|liberation	Launch directly into a game
--platform <name>	Select platform variant (dos, amiga, cd32)
--lang <code>	Override UI language (e.g. sv, de, ja)
--skip-intro	Skip the start menu and launch immediately
--scan-data	Scan and verify game data, then exit
--verify-data <path>	Verify a specific data file by SHA-256

Display

Option	Description
--scale <1-5>	Window scale multiplier (default: 4)
--resolution <WxH>	Set window size (e.g. 1920x1080)
--fullscreen	Start in fullscreen mode
--vsync	Enable vertical sync
--no-vsync	Disable vertical sync
--fps <0|30|60|120>	Frame rate limit (0 = unlimited)
--brightness <0-100>	Brightness level
--contrast <0-100>	Contrast level
--scanlines	Enable scanline overlay
--crt	Enable CRT curvature effect
--bilinear	Enable bilinear texture filtering
--integer-scaling	Force integer pixel scaling
--no-integer-scaling	Allow non-integer scaling (default)
--enhanced	Enable enhanced rendering mode

Custom Features

All custom features are opt-in and do not affect original game parity.

Option	Description
--all-features	Enable all custom features
--hd-upscale	Enable xBRZ pixel-art upscaling
--upscale-factor <2-4>	xBRZ scale factor
--widescreen	Expand to 16:9 aspect ratio
--quicksave	Enable multi-slot quicksave (10 slots)
--minimap	Enable minimap overlay
--mouse-look	Enable FPS-style mouse turning
--debug-hud	Enable debug HUD (F7 toggle)
--reverb	Enable audio reverb in dungeons
--hq-midi	Enable high-quality MIDI output filter
--automap	Reveal visited cells permanently
--dynamic-lighting	Enable per-pixel distance lighting
--speed <factor>	Game speed multiplier (e.g. 2.0)
--fast-travel	Enable fast travel in Liberation cities
--cross-save-export	Enable portable cross-save export
--features-config <file>	Load feature settings from file

Replay

Option	Description
--replay-record	Record input to replay file on exit
--replay-output <file>	Set replay output path
--replay-play <file>	Play back a recorded replay

Development

Option	Description
--capture-frame <file>	Capture a single frame to PPM
--extract-dos-vga <file> <out>	Extract DOS VGA palette
--compare-frames <a> <b>	Compare two PPM frames
--compare-frames-rect <a> <b> <x> <y> <w> <h>	Compare a rectangular region
--compare-frames-regions <a> <b> ...	Compare multiple regions
--show-liberation-mission-menu	Show Liberation mission debug menu

Data Paths

Game data is looked up in platform-specific locations:

Platform	Default path
Linux	~/.opencaptive/
macOS	~/.opencaptive/
Windows	<install-dir>\data
Android	/sdcard/OpenCaptive
iOS	Documents/OpenCaptive

Override with --data <path>.

Examples

# Launch Captive with enhanced graphics
opencaptive --game captive --hd-upscale --dynamic-lighting

# Full HD fullscreen with all features
opencaptive --resolution 1920x1080 --fullscreen --all-features

# Scan game data without launching
opencaptive --scan-data --data ~/games/captive

# Record a replay
opencaptive --replay-record --replay-output session.ocrp

# Swedish UI
opencaptive --lang sv