# allyhub audio

> How a video sounds: its mix's loudness, what the master did, silences, onsets against cuts and cues, pace, levels under and between the words, each part's speech and voice; or a file on its clock, or a file alone

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

## Usage

```bash
allyhub audio [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 |  | Measure this sound or video file on the video's clock instead of its mix (another render, a reference's sound); the video's own voice still comes from its takes |

## 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 |
| --- | --- | --- |
| `source` | object |  |
| `duration` | number |  |
| `loudness` | object |  |

## Examples

```bash
allyhub audio launch/film
allyhub audio launch/film --file export.mp4
allyhub audio 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

**video**: Making a video (one piece, or a batch of ads in combos)

[`check`](https://allyhub.com/docs/reference/cli/check.md) → [`frames`](https://allyhub.com/docs/reference/cli/frames.md) → [`inspect`](https://allyhub.com/docs/reference/cli/inspect.md) → [`inspect layout`](https://allyhub.com/docs/reference/cli/inspect-layout.md) → [`inspect timeline`](https://allyhub.com/docs/reference/cli/inspect-timeline.md) → [`inspect motion`](https://allyhub.com/docs/reference/cli/inspect-motion.md) → [`inspect still`](https://allyhub.com/docs/reference/cli/inspect-still.md) → [`inspect contrast`](https://allyhub.com/docs/reference/cli/inspect-contrast.md) → [`inspect seams`](https://allyhub.com/docs/reference/cli/inspect-seams.md) → [`inspect flash`](https://allyhub.com/docs/reference/cli/inspect-flash.md) → [`inspect loop`](https://allyhub.com/docs/reference/cli/inspect-loop.md) → [`inspect combos`](https://allyhub.com/docs/reference/cli/inspect-combos.md) → `audio` → [`add search`](https://allyhub.com/docs/reference/cli/add-search.md) → [`add`](https://allyhub.com/docs/reference/cli/add.md) → [`dev`](https://allyhub.com/docs/reference/cli/dev.md) → [`render`](https://allyhub.com/docs/reference/cli/render.md)

**references**: Studying reference videos, and a piece against them

[`reference`](https://allyhub.com/docs/reference/cli/reference.md) → [`reference compare`](https://allyhub.com/docs/reference/cli/reference-compare.md) → [`reference set`](https://allyhub.com/docs/reference/cli/reference-set.md) → [`frames`](https://allyhub.com/docs/reference/cli/frames.md) → [`frames compare`](https://allyhub.com/docs/reference/cli/frames-compare.md) → [`words`](https://allyhub.com/docs/reference/cli/words.md) → `audio` → [`align`](https://allyhub.com/docs/reference/cli/align.md)
