VideoRecompress Studio

View saved version →

---
name: contenta-video
description: Compress and re-encode video files with the VideoRecompress Studio CLI (videorecompress). Use when the user asks to shrink videos, convert to H.265/HEVC, AV1 or VP9, prepare videos for WhatsApp, Discord or email, archive phone, wedding, dashcam or screen recordings, batch-compress a folder, or watch a folder for new videos.
allowed-tools: Bash
---

> **Requires VideoRecompress Studio installed on this Windows PC** (download: https://www.contenta-software.com/videorecompress/download.php). The commands below run the app's command-line tool on the user's own computer, so they work in Codex and other local agents. In ChatGPT, which cannot run programs on the user's computer, use this skill to choose the right command and give it to the user to run.


# VideoRecompress Studio (video compression)

Use the `videorecompress` CLI (VideoRecompress Studio 2026.2.22+, Windows). Default per-user install: `%LOCALAPPDATA%\Programs\VideoRecompressStudio\videorecompress.exe`, on the user PATH. Check with `videorecompress --version` (it prints the build id after a `+`).

Relative and full paths both work for inputs, `--output`, `--profile` and watermark images.

Every command accepts `--json` (JSON on stdout, logs on stderr), `--quiet`, `-v`.

## Commands

```bash
videorecompress analyze <file> [--json]
videorecompress recompress <file> --output <dir> [--preset-id ID | --codec C --crf N] [options]
videorecompress batch <dir> --output <dir> [--preset-id ID | --codec C --crf N] [--workers 2] [--include "*.mp4"]
videorecompress presets [--json] [--preset-id ID]
videorecompress profile save|load|validate <file.json>
videorecompress watch --folder <dir> --preset <ID> [--output <dir>]     # runs until Ctrl+C, scans every 30 s
videorecompress register <email> <key>
videorecompress status                       # license, clean files left, tools, GPU encoders
```

`--output` is a folder; outputs keep the source name.

## Presets: two different flags

- `--preset-id <id>` = named preset (recompress, batch, profile save). Explicit flags override single settings.
- `--encoder-preset` = encoder speed (`ultrafast`..`veryslow`, or 0-13 for SVT-AV1; default `medium`). There is no `--preset` on recompress/batch.
- `watch` uses `-p/--preset <id>` for the named preset.

| Goal | `--preset-id` | Codec / CRF |
|------|---------------|-------------|
| Phone/home video archive | `phone_archive` | H.265 / 23 |
| Wedding/event archive (high quality) | `wedding_archive` | H.265 / 18 |
| Maximum savings | `max_savings` | AV1 / 35 |
| Surveillance | `security_archive` | H.265 / 28 |
| Dashcam / body cam | `dashcam_archive` | H.265 / 27 |
| Screen recordings | `screen_recording` | H.265 / 26 |
| Fast, plays everywhere | `quick_h264` | H.264 / 23 |
| Web (WebM) | `web_optimized` | VP9 / 30 |
| 4K down to 1080p | `4k_to_1080p` | H.265 / 22 |
| WhatsApp / email / Discord | `whatsapp`, `email_attachment`, `discord_free` | H.264 / 28-32 |

Full list: `videorecompress presets --json` (24 presets).

## Other options (recompress and batch)

`--quality-mode crf|cbr|twopass` + `--bitrate kbps` · `--hw-accel auto|nvenc|qsv|amf|software` · `--audio-mode copy|reencode|remove` · `--audio-codec aac|opus|mp3|flac|ac3|eac3` · `--audio-bitrate` · `--container mp4|mkv|webm` · `--width/--height` (a maximum; smaller videos are not enlarged) · `--trim-mode skip-start|skip-end|keep-first|custom` + `--trim-duration`/`--trim-start`/`--trim-end` (seconds of the source) · `--denoise off|light|medium|strong` · `--deinterlace off|yadif|yadif-bob` · `--watermark-text/--watermark-image` + `--watermark-position TopLeft..BottomRight` · `--fps/--fps-mode` · `--overwrite` · `--profile file.json` · `--measure-quality` (SSIM/VMAF). batch: `-r/--recursive` (default on), `-w/--workers` (default 2), `--include/--exclude`.

Option values are checked: an unknown `--codec`, `--hw-accel`, `--container`, `--quality-mode`, `--audio-*`, `--denoise`, `--deinterlace`, `--trim-mode`,

Preview of the first 4,000 characters. Read full instructions →