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

> Create cinematic camera animations and record smooth flythrough videos of your worlds.

# Record

<iframe width="100%" height="400" src="https://www.youtube.com/embed/fvZBjq3I4h4" title="Welcome to Marble" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

# Record: creating camera animations

Use Record to create smooth camera animations and capture cinematic flythroughs
of your worlds. Perfect for showcasing environments, creating trailers, or producing
professional presentations of your 3D scenes.

<Warning>
  **Important: data persistence limitation**

  Currently the trajectory does not persist. You **WILL lose the keyframes** when you leave the page. Similarly, you **WILL lose the enhanced video** if you leave the page. Stay on the page until your (enhanced) videos have finished downloading.
</Warning>

## Getting started with record

The Studio Record interface provides comprehensive animation tools:

* **3D viewport**: View your world with camera animation preview
* **Camera frustum**: Yellow wireframe showing camera view and movement path
* **Animation timeline**: Control playback, timing, and keyframes
* **Playback controls**: Play, pause, and scrub through your animation
* **Export tools**: Enhance and export your final video

## How to set up your camera animation

Create smooth camera movements through your world:

1. **Position your camera**: Move to your desired starting viewpoint in the 3D viewport
2. **Set first keyframe**: The camera frustum (yellow wireframe) shows your view cone
3. **Move to next position**: Navigate to where you want the camera to move
4. **Add more keyframes**: Build your camera path with multiple positions
5. **Preview movement**: The yellow path lines show your camera's trajectory

## How to control animation timing

Fine-tune the pacing of your camera movement:

1. **Use the timeline**: The bottom timeline shows seconds
2. **Scrub through time**: Drag the blue playhead to preview different moments
3. **Adjust keyframe timing**: Move keyframes along the timeline to change pacing
4. **Set animation length**: Extend or shorten the total duration as needed
5. **Preview timing**: Use playback controls to test your animation speed

## How to preview your animation

Review your camera movement before recording:

1. **Click play**: Use the <Icon icon="play" /> play button to start animation preview
2. **Pause and adjust**: Use <Icon icon="pause" /> pause to stop and make adjustments
3. **Scrub timeline**: Drag the playhead to jump to specific moments
4. **Check camera path**: Watch the yellow frustum move along the path
5. **View from animation**: The preview window shows your camera's perspective

## How to record and export

Capture your final animation:

1. **Preview first**: Ensure your animation looks correct using the preview controls
2. **Use enhance**: Click <Icon icon="sparkles" /> **Enhance** to improve video quality and effects. Wait on this page until the enhance is done.
3. **Download video**: Click <Icon icon="download" /> **Download** to download your final animation file

## FAQ

### What does the yellow wireframe represent?

The **Camera frustum** (yellow wireframe cone) shows exactly what your camera sees at each moment, including the field of view and viewing direction. The lines connecting different positions show your camera's movement path.

### How long can my animation be?

The timeline extends beyond 8 seconds, allowing for longer animations. However, longer videos may take more time to process and export.

### What does the enhance feature do?

**Enhance** applies post-processing effects like improved lighting, color grading, and visual effects to make your video look more professional and cinematic.

### Can I edit keyframes after creating them?

Yes, you can move keyframes along the timeline to adjust timing, and reposition your camera at any keyframe to change the path.

### What file formats can I export?

A mp4 video.

### How do I create smooth camera movements?

Focus on gentle curves rather than sharp angles, use consistent speeds between keyframes, and preview frequently to ensure the movement feels natural.

## Keyboard shortcuts and controls reference

Master the Studio Record interface with these keyboard shortcuts and button tooltips for efficient animation workflow.

### Animation keyframe controls

Create and manage keyframes with these essential shortcuts:

* **<kbd>F</kbd>** - <Icon icon="diamond-plus" /> Add keyframe at current camera position
* **<kbd>U</kbd>** - <Icon icon="switch-camera" /> Update selected keyframe to current camera position
* **<kbd>Delete</kbd>** / **<kbd>Backspace</kbd>** - <Icon icon="diamond-minus" /> Delete selected keyframe

### Timeline playback controls

Navigate through your animation timeline efficiently:

* **<kbd>Space</kbd>** - <Icon icon="play" />/<Icon icon="pause" /> Toggle play/pause animation
* **<kbd>G</kbd>** - <Icon icon="skip-back" /> Jump to beginning of timeline
* **<kbd>H</kbd>** - <Icon icon="step-back" /> Jump to previous keyframe
* **<kbd>L</kbd>** - <Icon icon="step-forward" /> Jump to next keyframe
* **<kbd>;</kbd>** (semicolon) - <Icon icon="skip-forward" /> Jump to end of timeline

### Seek and scrubbing controls

Fine-tune your position in the animation:

* **<kbd>J</kbd>** - <Icon icon="rewind" /> Seek backward (hold to continue seeking)
* **<kbd>K</kbd>** - <Icon icon="fast-forward" /> Seek forward (hold to continue seeking)

### Camera movement controls

Navigate your 3D world while setting up animations:

* **<kbd>W</kbd>** - Move forward
* **<kbd>A</kbd>** - Move left
* **<kbd>S</kbd>** - Move backward
* **<kbd>D</kbd>** - Move right
* **<kbd>E</kbd>** - Move up
* **<kbd>Q</kbd>** - Move down
* **<kbd>Shift</kbd>** - Speed up movement

### View controls

Adjust your viewing perspective:

* **<kbd>\[</kbd>** - Decrease field of view (FOV)
* **<kbd>]</kbd>** - Increase field of view (FOV)
* **<kbd>0</kbd>** - Return to origin position

### Timeline interface buttons

The timeline interface includes these interactive controls with tooltips:

#### Playback controls section

* <Icon icon="skip-back" /> "Jump to beginning (<kbd>G</kbd>)" - Moves playhead to start of timeline
* <Icon icon="step-back" /> "Jump to previous keyframe (<kbd>H</kbd>)" - Moves playhead to previous keyframe
* <Icon icon="play" />/<Icon icon="pause" /> "Play" / "Pause (Space)" - Toggles animation playback
* <Icon icon="step-forward" /> "Jump to next keyframe (<kbd>L</kbd>)" - Moves playhead to next keyframe
* <Icon icon="skip-forward" /> "Jump to end (<kbd>;</kbd>)" - Moves playhead to end of timeline

### Pro tips for efficient animation workflow

1. **Add keyframes frequently** - Add keyframes with <kbd>F</kbd> as you explore to build smooth camera paths
2. **Preview with <kbd>Space</kbd>** - Constantly test your animation timing with the play shortcut
3. **Scrub with <kbd>H</kbd>/<kbd>L</kbd>** - Fine-tune timing by holding these keys to seek through your animation
4. **Speed up navigation** - Hold <kbd>Shift</kbd> while moving to quickly position your camera
5. **Reset with <kbd>0</kbd>** - Return to origin if you get lost while positioning your camera
