Automate Video Compression From the Command Line

Automate batch recompression, GPU-accelerated encoding, and professional workflows from your terminal or CI/CD pipeline.

Download Free Trial

$79 one-time. No subscription. CLI included with every license.

Quick Start

1 Install
2 Run
3 Automate

Download VideoRecompress Studio. The CLI is included — add the install directory to your PATH.

8 Commands

CommandWhat It Does
videorecompress analyzeShow video file info: codec, resolution, duration, bitrate, audio streams
videorecompress recompressRecompress a single video with codec, CRF, hardware acceleration, watermark, and trim options
videorecompress batchBatch recompress an entire directory with parallel workers and preset selection
videorecompress presetsList all 24 built-in presets with their codec and CRF
videorecompress profileLoad or save recompression settings from a JSON profile
videorecompress watchWatch a folder and automatically recompress new videos as they arrive
videorecompress statusCheck license and registration status
videorecompress serveStart the MCP server for AI agent integration (stdio transport)

Usage Examples

# Analyze a video file
videorecompress analyze video.mp4 --json

# Recompress with H.265 at quality 20
videorecompress recompress video.mp4 --codec h265 --crf 20

# Batch recompress a whole folder
videorecompress batch ./videos --codec h265 --crf 20 --workers 3

# Watch folder for new videos
videorecompress watch --folder ./incoming --preset phone_archive -o ./compressed

# Inspect a video and estimate savings (JSON)
videorecompress analyze video.mp4 --json

# GPU-accelerated recompression
videorecompress recompress video.mp4 --codec h265 --hw-accel auto

7 of the 24 Built-in Presets

Ready-to-use presets for common workflows. Use with --preset name on any command.

PresetCodec & QualityName in the app
phone_archiveH.265, CRF 23Phone Video Archive
youtube_rawH.265, CRF 20YouTube Raw Footage
security_archiveH.265, CRF 28Security Camera Archive
wedding_archiveH.265, CRF 18Wedding / Event Archive
max_savingsAV1, CRF 35Maximum Savings
quick_h264H.264, CRF 23Quick H.264 Repack
web_optimizedVP9, CRF 30Web Optimized

MCP Server — AI Agent Integration

Run videorecompress serve to start a Model Context Protocol server on stdio. AI agents like Claude can then analyze, recompress, and batch-process videos through natural language.

MCP ToolDescription
analyze_videoAnalyze a video file — returns codec, resolution, duration, bitrate, audio and subtitle streams
recompress_videoRecompress a single video with full option set (codec, CRF, hardware acceleration, trim, watermark)
batch_recompressBatch recompress a directory with worker pools and preset selection
list_presetsList all 24 built-in presets with their settings
estimate_savingsEstimate file size reduction for a video without encoding
// claude_desktop_config.json
{
  "mcpServers": {
    "videorecompress": {
      "command": "videorecompress",
      "args": ["serve"]
    }
  }
}

MCP server works during trial. All 5 tools available. Trial adds a subtle watermark after 10 files.

Use it from your AI agent

VideoRecompress Studio ships an MCP server, so Claude Code, Cursor, Codex, VS Code and other agents that run on your PC can compress your videos through it. Your files stay on your computer.

In Claude Code, two commands:

/plugin marketplace add contentasoftware/videorecompress-studio-plugin
/plugin install videorecompress-studio@videorecompress-studio-plugin

In Cursor, Claude Desktop, VS Code or any other MCP client, add this server entry (needs Node.js 18 or newer):

// mcpServers
"videorecompress-studio": { "command": "cmd", "args": ["/c", "npx", "-y", "@contentasoft/videorecompress-mcp"] }

Once VideoRecompress Studio is installed, you can skip Node.js and point the client at the app's own CLI instead:

"videorecompress-studio": { "command": "videorecompress", "args": ["serve"] }

It works during the free trial, with the same limits as the app. Plugin source on GitHub, launcher package on npm: GitHub · npm

Licensing

FeatureTrialRegistered ($79)
analyze, recompress, batch, presetsWatermark after 10 filesFull access
watch, profileWatermark after 10 filesFull access
MCP Server (videorecompress serve)Watermark after 10 filesFull access
statusFull accessFull access

Download VideoRecompress Studio

Free trial with no time limit: your first 10 files convert with no watermark; after that files get a watermark and a 10-minute cap. Buying removes both. CLI and MCP server included, no credit card required.

Download Free Trial