Initial commit

2026-04-05 17:19:06 +02:00
commit b622786943
6 changed files with 337 additions and 0 deletions
@@ -0,0 +1,55 @@
+# recscripts
+
+FFmpeg encode helpers for FPV recordings (HDZero, Analog, Walksnail).
+
+## Install
+
+Requires [ffmpeg](https://ffmpeg.org/) (includes `ffprobe`) on your PATH.
+
+```sh
+uv pip install -e .
+```
+
+## Commands
+
+### `hdzero`
+
+Encode HDZero recordings with denoise, scale, and sharpen.
+
+```sh
+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**
+
+```bash
+# 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
+```