56 lines
1.6 KiB
Markdown
56 lines
1.6 KiB
Markdown
# 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
|
|
```
|