vedit 0.1.1

A tool that wraps auto-editor and ffmpeg for fast editing.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

# vedit

`vedit` is a small Rust command-line wrapper that runs `auto-editor` to remove silent parts from a video and then uses `ffmpeg` to adjust playback speed.

It automates the two-step process: run `auto-editor` with a configurable margin, then apply video and audio speed filters with `ffmpeg`.

This tool expects `auto-editor` and `ffmpeg` to be available on your PATH.

## Requirements

- Rust (stable) — to build the project
- `auto-editor` — installed and available on your PATH
- `ffmpeg` — installed and available on your PATH

Note: `vedit` assumes that after running:
`auto-editor <input> --margin <N>sec`,
an altered file will exist with the same stem as the input and the suffix `_ALTERED` (e.g. `video.mp4` -> `video_ALTERED.mp4`).

## Building

From cargo:

```bash
cargo install vedit
```

From the project root:

```bash
# Build in release mode, binary will be in ~/.cargo/bin
cargo install --path .
```

## Usage

Basic invocation:

```bash
vedit <input> --margin <seconds> --speed <factor> --output <output>
```

Arguments:

- `<input>` — Path to the input video file (positional).
- `--margin` — Margin in seconds passed to `auto-editor` (float, e.g. `0.2`).
- `--speed` — Playback speed factor applied with `ffmpeg` (float, e.g. `1.25`, `1.5`, `2.0`).
- `--output` — Output filename for the final processed video.

Example:

```bash
# Remove silent parts (with 0.2s margin) then speed playback 1.5x, writing to output.mp4
vedit input.mp4 --margin 0.2 --speed 1.5 --output output.mp4
```

## How it works

The CLI performs the following steps:

1. Parses arguments.
2. Runs:
   - `auto-editor <input> --margin <margin>sec`
   - Expects an altered file named `<stem>_ALTERED.<ext>` to exist after that command.
3. Runs `ffmpeg` on the altered file to change speed:
   - Video filter: `setpts=PTS/<speed>`
   - Audio filter: `atempo=<speed>`
4. Writes the final file to the path provided by `--output`.

The code returns errors when the external commands exit with non-zero status:

- If `auto-editor` fails, the program reports `auto-editor failed`.
- If `ffmpeg` fails, the program reports `ffmpeg failed`.

## Contributing

This project is intentionally small. Feel free to open a PR.