create-render-profile

Create Render Profile

Walks the user through building a render profile interactively, with a tight feedback loop: render a short test clip, inspect file size + bitrate, tune, repeat.

This is the antidote to "GPU-encoded but bloated". The goal is a profile the user trusts — saved by name, reused across jobs.

Procedure

1. Resolve the system profile

DATA_DIR="${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/video-editing"
PROFILE_FILE="$DATA_DIR/system-profile.json"
PROFILES_FILE="$DATA_DIR/render-profiles.json"
test -f "$PROFILE_FILE" || { echo "No system profile — run profile-system first."; exit 1; }

Read preferred encoders and the VAAPI render node from system-profile.json.

2. Ask the user

Field	Example	Default
Profile name	youtube-1080p	required, slugify
Container	mp4 / mkv / mov	mp4
Codec	h264 / hevc / av1	hevc (best size/quality)
Resolution	1920x1080 / 3840x2160 / source	source
Framerate	30 / 60 / source	source
Quality target	"small file", "YouTube", "archival"	"YouTube"
Sample clip	path to a representative source file	required

Map quality target → starting QP / bitrate (per encoder). Reasonable starting points:

• VAAPI HEVC: -qp 23 (YouTube), -qp 20 (archival), -qp 28 (small file)
• VAAPI H.264: -qp 22 (YouTube), -qp 18 (archival), -qp 27 (small file)
• libx264/libx265: -crf 20 / -crf 23 / -crf 28

3. Build the ffmpeg command

For AMD VAAPI HEVC at 1080p:

ffmpeg -hide_banner -ss 0 -t 30 -i "<sample>" \
  -vaapi_device "<render_node>" \
  -vf 'format=nv12,hwupload,scale_vaapi=w=1920:h=1080' \
  -c:v hevc_vaapi -qp <QP> \
  -c:a aac -b:a 192k \
  -movflags +faststart \
  "<test_out>"

For software fallback (x265):

ffmpeg -hide_banner -ss 0 -t 30 -i "<sample>" \
  -vf scale=1920:1080 \
  -c:v libx265 -crf <CRF> -preset medium \
  -c:a aac -b:a 192k \
  -movflags +faststart \
  "<test_out>"