# Recorder

> Record a video stream to a file while Record is on. Audio joins when external audio buses land.

Source: https://docs.tune.toys/nodes/media.recorder/

Recorder records a video stream to a file while Record is on.

## What it does

FPS and Bitrate set the recording quality. The file is saved to the device when recording stops; the Toy never uploads it. Audio in recordings comes later.

## When to use it

Use it to keep the result of a filter chain or a switcher.

## Ports

<!-- ports:start -->

| Port    | Direction | Signal | Lanes |
| ------- | --------- | ------ | ----- |
| `video` | Input     | Video  | 1     |

<!-- ports:end -->

## Parameters

<!-- parameters:start -->

| Parameter      | Label      | Range    | Default | Unit   | Scale  | Notes                                                                                 |
| -------------- | ---------- | -------- | ------- | ------ | ------ | ------------------------------------------------------------------------------------- |
| `record`       | Record     | 0 to 1   | 0       |        | linear | Start or stop recording; stopping finishes the file. Choices: 0 Stopped, 1 Recording. |
| `fps`          | Frame rate | 10 to 60 | 30      | fps    | linear | Frames per second of the recording.                                                   |
| `bitrate_mbps` | Bitrate    | 1 to 40  | 8       | Mbit/s | log    | Target video bitrate.                                                                 |

<!-- parameters:end -->

### Record (`record`)

Records while on.

### Frame rate (`fps`)

Frames per second of the recording, from 10 to 60.

### Bitrate (`bitrate_mbps`)

Video bitrate in megabits per second. It is logarithmic.

## Tips

- Stop recording to finish the file.
- Video needs the browser's WebGPU video engine. The Player and exports do not run video yet and report it unavailable. To see a video output, bind a live Screen in the Frame to it.

## See also

[Snapshot](https://docs.tune.toys/nodes/video.snapshot/), [Camera](https://docs.tune.toys/nodes/video.camera/), [Media player](https://docs.tune.toys/nodes/media.player/), [Video](https://docs.tune.toys/concepts/video/), [Control lanes](https://docs.tune.toys/concepts/control-lanes/).
