# allyhub frames cuts

> A review sheet per cut of a video (a cut take's jumps, part joins, a scenery camera's cuts): frames around it, waveform and level, the words each side, the sound at it

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

## Usage

```bash
allyhub frames cuts [item] [options]
```

## Arguments

| Argument | Type | What it is |
| --- | --- | --- |
| `<item>` | string | The piece: its id (its file without its extension) or its file; default the project's only one |

## Options

| Option | Type | Default | What it does |
| --- | --- | --- | --- |
| `--combo` | list of string |  | The first combo matching name=value pairs joined with commas (lang=zh-cn,hook=b), or a combo's id (c03); default the first combo |
| `--part` | string |  | Only this part's cuts and its joins |
| `--out` | string |  | The folder the sheets go in; default .allyhub/work/cuts/ |

## Parameters

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

| Name | Type | Default | What it does |
| --- | --- | --- | --- |
| `span` | number | `1` | Seconds shown on each side of a cut |

## 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 |
| --- | --- | --- |
| `out` | string |  |
| `cuts` | list of object |  |

## Examples

```bash
allyhub frames cuts launch/film
allyhub frames cuts launch/film --part hook
```

## 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`](https://allyhub.com/docs/reference/cli/words-edits.md) → [`align`](https://allyhub.com/docs/reference/cli/align.md) → `frames cuts` → [`audio recording`](https://allyhub.com/docs/reference/cli/audio-recording.md) → [`render`](https://allyhub.com/docs/reference/cli/render.md)
