Update to VideoRecompress Studio

{
  "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.",
  "included_files": [],
  "name": "contenta-video",
  "skill_md_contents": "---\nname: contenta-video\ndescription: 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.\nallowed-tools: Bash\n---\n\n> **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.\n\n\n# VideoRecompress Studio (video compression)\n\nUse 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 `+`).\n\nRelative and full paths both work for inputs, `--output`, `--profile` and watermark images.\n\nEvery command accepts `--json` (JSON on stdout, logs on stderr), `--quiet`, `-v`.\n\n## Commands\n\n```bash\nvideorecompress analyze <file> [--json]\nvideorecompress recompress <file> --output <dir> [--preset-id ID | --codec C --crf N] [options]\nvideorecompress batch <dir> --output <dir> [--preset-id ID | --codec C --crf N] [--workers 2] [--include \"*.mp4\"]\nvideorecompress presets [--json] [--preset-id ID]\nvideorecompress profile save|load|validate <file.json>\nvideorecompress watch --folder <dir> --preset <ID> [--output <dir>]     # runs until Ctrl+C, scans every 30 s\nvideorecompress register <email> <key>\nvideorecompress status                       # license, clean files left, tools, GPU encoders\n```\n\n`--output` is a folder; outputs keep the source name.\n\n## Presets: two different flags\n\n- `--preset-id <id>` = named preset (recompress, batch, profile save). Explicit flags override single settings.\n- `--encoder-preset` = encoder speed (`ultrafast`..`veryslow`, or 0-13 for SVT-AV1; default `medium`). There is no `--preset` on recompress/batch.\n- `watch` uses `-p/--preset <id>` for the named preset.\n\n| Goal | `--preset-id` | Codec / CRF |\n|------|---------------|-------------|\n| Phone/home video archive | `phone_archive` | H.265 / 23 |\n| Wedding/event archive (high quality) | `wedding_archive` | H.265 / 18 |\n| Maximum savings | `max_savings` | AV1 / 35 |\n| Surveillance | `security_archive` | H.265 / 28 |\n| Dashcam / body cam | `dashcam_archive` | H.265 / 27 |\n| Screen recordings | `screen_recording` | H.265 / 26 |\n| Fast, plays everywhere | `quick_h264` | H.264 / 23 |\n| Web (WebM) | `web_optimized` | VP9 / 30 |\n| 4K down to 1080p | `4k_to_1080p` | H.265 / 22 |\n| WhatsApp / email / Discord | `whatsapp`, `email_attachment`, `discord_free` | H.264 / 28-32 |\n\nFull list: `videorecompress presets --json` (24 presets).\n\n## Other options (recompress and batch)\n\n`--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`.\n\nOption values are checked: an unknown `--codec`, `--hw-accel`, `--container`, `--quality-mode`, `--audio-*`, `--denoise`, `--deinterlace`, `--trim-mode`, `--fps-mode` or `--watermark-position` exits 2 and names the valid values; `--crf` must be 0-63; `--quality-mode cbr|twopass` needs `--bitrate`; H.264/H.265 cannot go into WebM (use `--codec vp9` or `av1`). The presets `gif_creator`, `youtube_thumbnails` and `video_contact_sheet` write several files and work only with `batch`.\n\nTrim examples: `--trim-mode keep-first --trim-duration 10` keeps the first 10 s; `--trim-mode custom --trim-start 5 --trim-end 12` keeps 0:05-0:12 of the source.\n\n## Examples (verified on 2026.2.22)\n\n```powershell\nvideorecompress analyze video.mp4 --json\nvideorecompress recompress video.mp4 --output .\\compressed\nvideorecompress recompress video.mp4 --codec h265 --crf 18 --encoder-preset slow --output .\\archive\nvideorecompress recompress video.mp4 --trim-mode keep-first --trim-duration 10 --output .\\first10\nvideorecompress recompress small.3gp --preset-id whatsapp --output .\\whatsapp\nvideorecompress batch .\\videos --preset-id phone_archive --workers 2 --output .\\compressed\nvideorecompress batch .\\videos --codec av1 --crf 35 --output .\\av1 --json\nvideorecompress watch --folder .\\incoming --preset phone_archive --output .\\compressed\n```\n\n`batch --json` always prints, even for an empty folder: one JSON object per line, `{\"type\":\"progress\",...}` objects, then a summary `{\"success\":true,\"cancelled\":false,\"totalFiles\":N,\"processed\":N,\"failed\":0,\"skipped\":0,\"durationMs\":...,\"errors\":[]}` (with a `message` when nothing was encoded, for example `All files skipped (same codec as target).`).\n\n## Exit codes\n\n0 success · 1 general error · 2 invalid arguments (including every bad option value) · 3 not used (older versions: trial ended) · 4 recompression failed (also `analyze` or `recompress` on a file that is not media, and a `batch` with a failed file) · 5 file or folder not found · 6 ffmpeg/ffprobe missing.\n\n## Guidelines\n\n- Run `analyze` first; report size before and after.\n- If re-encoding would make a file bigger, the original video is kept and the CLI says \"This video was already well compressed\". Presets with a fixed size (e.g. `whatsapp`, `4k_to_1080p`) never enlarge a smaller video.\n- Hardware encoding is automatic; `--hw-accel software` forces the CPU.\n- Trial: no end date. This computer's first 10 files (lifetime, plus 10 after the newsletter confirmation in the app) are unrestricted; every later file is watermarked and cut at 10 minutes. Nothing stops working; `videorecompress register <email> <key>` removes the watermark and the cap.\n"
}