recscripts
FFmpeg encode helpers for FPV recordings (HDZero, Analog, Walksnail).
Install
Requires ffmpeg (includes ffprobe) on your PATH.
uv pip install -e .
Commands
hdzero
Encode HDZero recordings with denoise, scale, and sharpen.
hdzero <input> <output> [options]
Options
| Flag | Default | Description |
|---|---|---|
-ss <time> |
— | Start time (e.g. 00:01:30 or 90) |
-to <time> |
— | End time (e.g. 00:02:00 or 120) |
--crop |
off | Crop to 4:3 |
--no-audio |
off | Strip audio |
--height <px> |
1080 |
Output height |
--crf <n> |
23 |
Quality (lower = better) |
--preset <name> |
fast |
Encoder preset |
--gpu [nvidia|amd|intel] |
off | Use GPU encoder |
--threads <n> |
all | Limit CPU threads |
-n, --dry-run |
off | Print ffmpeg command without running |
Examples
# Basic encode
hdzero VID_0013.TS output.mp4
# Crop to 4:3, strip audio
hdzero VID_0013.TS output.mp4 --crop --no-audio
# Trim a clip
hdzero VID_0013.TS clip.mp4 -ss 00:01:00 -to 00:02:30
# GPU encode (NVIDIA)
hdzero VID_0013.TS output.mp4 --gpu
# Limit CPU usage
hdzero VID_0013.TS output.mp4 --threads 4