November sale: 50% off the lifetime license until November 3021 days leftBuy now →

Shrink a folder of videos from the command line or an AI agent

Point Claude Code, Cursor, Codex or a nightly task at a folder and get the same videos back, smaller. The videorecompress command and its MCP server use the same H.265, AV1 and GPU encoding as the desktop app. Both install with the trial.

Download Free Trial

$79 one-time, or subscribe. 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.

10 Commands

CommandWhat It Does
videorecompress infoShow 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 formatsList the containers and codecs it reads and writes
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 registerRegister your license key on this PC
videorecompress serveStart the MCP server for AI agent integration (stdio transport)

Usage Examples

# Inspect a video file (JSON)
videorecompress info video.mp4 --json

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

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

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

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

# List the containers and codecs it can write
videorecompress formats --output

# License state and free files left (JSON)
videorecompress status --json

Full CLI and MCP reference: every command, option, exit code and MCP tool (in English) →

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. Claude Code, Cursor, Codex, VS Code and other MCP clients can then analyze, recompress and batch-process videos when you ask in plain words.

MCP ToolDescription
get_file_infoAnalyze 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 how much smaller one video gets with a preset, by encoding three 4-second samples
list_formatsList the containers and codecs it reads and writes
get_license_statusLicense and trial state: free files left before the watermark
register_licenseRegister your license key from the AI assistant, without opening the app
// claude_desktop_config.json
{
  "mcpServers": {
    "videorecompress-studio": {
      "command": "videorecompress",
      "args": ["serve"]
    }
  }
}

analyze_video still works as the old name of get_file_info. The MCP server works during the trial, with every tool and the same limits as the app.

Full CLI and MCP reference: every command, option, exit code and MCP tool (in English) →

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)
info, recompress, batch, presets, formatsWatermark after 10 filesFull access
watch, profileWatermark after 10 filesFull access
MCP Server (videorecompress serve)Watermark after 10 filesFull access
status, registerFull 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