# allyhub audio recording

> How a video's voice is recorded: its speech as its mic settings record it (the room, the room tone, the spectrum, the dynamics), a file's beside it with the differences, and the video's setting fitted to the file; or a file alone

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

## Usage

```bash
allyhub audio recording [item] [options]
```

## Arguments

| Argument | Type | What it is |
| --- | --- | --- |
| `<item>` | string | The video: its id or its file (default the project's only one); or a sound or video file, measured alone |

## 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 |
| `--file` | string |  | A sound or video file measured whole beside the video's voice, with the differences |
| `--mix` | boolean | `false` | Measure the video's whole mix, as mastered, as a file is measured, not its speech alone |
| `--fit` | boolean | `false` | Fit the video's mic setting to --file's recording (keeping its setup), and print it for video({ mic }) |

## 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 |
| --- | --- | --- |
| `measured` | `speech`, `mix`, `file` |  |

## Examples

```bash
allyhub audio recording launch/film
allyhub audio recording launch/film --file reference.m4a --fit
allyhub audio recording reference.m4a
```

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