# allyhub align

> The offset between recordings of the same moment, from their sound, with how sharply they match and how it drifts

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

## Usage

```bash
allyhub align [reference] [others…] [options]
```

## Arguments

| Argument | Type | What it is |
| --- | --- | --- |
| `<reference>` | string | The recording the others are measured against |
| `<others>` | list of string | The recordings to measure: other = reference + offset |

## Parameters

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

| Name | Type | Default | What it does |
| --- | --- | --- | --- |
| `max` | number |  | The largest offset looked for either way, seconds (default any that leaves common sound) |

## 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 |
| --- | --- | --- |
| `reference` |  |  |
| `files` | list of object |  |

## Examples

```bash
allyhub align assets/media/mic.wav assets/media/cam.mp4
allyhub align mic.wav cam.mp4 --param max=10
```

## 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` → [`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)

**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`](https://allyhub.com/docs/reference/cli/audio.md) → `align`
