> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Exports

> Render and download karaoke exports in the cloud or on the local machine

An export is a rendered artifact produced from a project. Exports run in the cloud by default. Pass `--local` to render on your own machine with the local Remotion pipeline.

## `export create`

Render a new export for a project.

```bash theme={null}
youka export create <projectId> [options]
```

<ParamField path="projectId" type="string" required>
  The project to export.
</ParamField>

### Options

| Option                  | Description                                           |
| ----------------------- | ----------------------------------------------------- |
| `--resolution <value>`  | `480p`, `720p`, `1080p`, or `4k`                      |
| `--quality <value>`     | `low`, `medium`, or `high`                            |
| `--speed <number>`      | Playback speed multiplier                             |
| `--tone <number>`       | Pitch shift multiplier                                |
| `--transparent`         | Render with a transparent background                  |
| `--preset <presetId>`   | Preset override for this export                       |
| `--volume <stem=value>` | Set stem volume by type. Repeatable                   |
| `--local`               | Render locally instead of in the cloud                |
| `--download`            | Wait for the export and download it                   |
| `--output <path>`       | Output file or directory for local render or download |

### Stem volumes

Use `--volume <type>=<value>`. Valid types are `original`, `vocals`, `instrumental`, and `backing_vocals`. Values must be between `0` and `1`.

### Cloud render

```bash theme={null}
youka export create $PROJECT_ID \
  --resolution 1080p \
  --quality high \
  --wait \
  --download \
  --output ./karaoke.mp4 \
  --json
```

### Local render

Local rendering runs the Remotion pipeline on your machine. First ensure the render dependencies are installed:

```bash theme={null}
youka deps ensure --for render
```

Then export with `--local`:

```bash theme={null}
youka export create $PROJECT_ID \
  --local \
  --resolution 1080p \
  --output ./karaoke.mp4 \
  --json
```

<Note>
  Local renders write directly to the `--output` path. Do not pass `--download`
  with `--local`; the CLI rejects that combination because there is no cloud
  artifact to download after a local render.
</Note>

## `export quote`

Quote the credits required for a cloud export without starting the export.

```bash theme={null}
youka export quote <projectId> [options]
```

`export quote` only quotes cloud exports. Local exports run on your machine and
do not use cloud export credits.

| Option                  | Description                          |
| ----------------------- | ------------------------------------ |
| `--resolution <value>`  | `480p`, `720p`, `1080p`, or `4k`     |
| `--quality <value>`     | `low`, `medium`, or `high`           |
| `--speed <number>`      | Playback speed multiplier            |
| `--tone <number>`       | Pitch shift multiplier               |
| `--transparent`         | Render with a transparent background |
| `--preset <presetId>`   | Preset override for this export      |
| `--volume <stem=value>` | Set stem volume by type. Repeatable  |

Example:

```bash theme={null}
youka export quote $PROJECT_ID \
  --resolution 1080p \
  --quality high \
  --json
```

## `export list`

List exports for a project.

```bash theme={null}
youka export list <projectId> [--page <n>] [--page-size <n>]
```

| Option        | Default | Description               |
| ------------- | ------- | ------------------------- |
| `--page`      | `1`     | Page number.              |
| `--page-size` | `100`   | Page size. Maximum `100`. |

Example:

```bash theme={null}
youka export list $PROJECT_ID --page-size 50 --json
```

## `export show`

Fetch one export by ID.

```bash theme={null}
youka export show <exportId>
youka export show <exportId> --json
```

## `export wait`

Poll an export until it reaches a terminal state.

```bash theme={null}
youka export wait <exportId> --json
```

## `export download`

Download an existing export by ID.

```bash theme={null}
youka export download <exportId> [--output <file>]
```

Example:

```bash theme={null}
youka export download $EXPORT_ID \
  --output ./karaoke.mp4
```

## What's next

* [Projects](/en/cli/projects) - create or wait on projects before exporting
* [Presets](/en/cli/presets) - reuse render settings across exports
* [Dependencies](/en/cli/deps) - inspect and install local render dependencies