# allyhub words edits

> What a cut list keeps of a recording: the stretches kept, every word and sound removed, the room tone at its ends, and every join measured on both sides

Source: https://allyhub.com/docs/reference/cli/words-edits · AllyHub 0.10.0
Index of all docs: https://allyhub.com/llms.txt

## Usage

```bash
allyhub words edits [file] [edits] [options]
```

## Arguments

| Argument | Type | What it is |
| --- | --- | --- |
| `<file>` | string | The recording: an audio or video file |
| `<edits>` | string | The edits file: the cut list (words, sounds, stretches inside words, pauses) to report on |

## Parameters

Each is given as `--param name=value`.

| Name | Type | Default | What it does |
| --- | --- | --- | --- |
| `fps` | number | `30` | The frame grid cuts are placed on |

## Global options

`--dir <value>`: the project's folder; default the one around where it is run. `--json`: print the result as JSON.

## Output

With `--json`, the command prints an object with these fields:

| Field | Type | What it is |
| --- | --- | --- |
| `file` | string |  |
| `wordsFile` | string |  |
| `cut` |  |  |

## Examples

```bash
allyhub words edits talk/host.mp4 talk/edits/host.json
allyhub words edits host.mp4 edits.json --param fps=25
```

## Exit codes

`0` when it succeeds; the others are listed in [Exit codes](https://allyhub.com/docs/reference/cli/exit-codes.md).

## In the work

**footage**: Cutting recorded footage: a talking head, an interview

[`words`](https://allyhub.com/docs/reference/cli/words.md) → `words edits` → [`align`](https://allyhub.com/docs/reference/cli/align.md) → [`frames cuts`](https://allyhub.com/docs/reference/cli/frames-cuts.md) → [`audio recording`](https://allyhub.com/docs/reference/cli/audio-recording.md) → [`render`](https://allyhub.com/docs/reference/cli/render.md)
