# 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
```