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

# Timeline and animation

> Play a 3D scene, keyframe its cameras and objects, or place animation clips.

The Timeline sits under the 3D canvas. It lists the scene's objects, cameras and audio as rows, with their clips and keyframes against a time ruler.

![The Timeline. Box 1 is on the play button and time, 2 on the time ruler, 3 on the pinned row for the selected p5-sliding-box, 4 on its animation clip, and 5 on the bar of Camera 2 with its keyframes.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/setups-cameras/timeline-overview.jpg?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=6485a1ea9ead480248ec2917b20f7b01)

1. Play and the time
2. Time ruler
3. Selected item
4. Animation clip
5. Camera keyframes

## Play the scene

Click play or press **Space**. The playhead runs across the ruler, and animated objects move in the canvas.

| Key | Does |
| - | - |
| **Space** | Play or pause |
| **←** / **→** | One frame back or forward |
| **Shift+←** / **Shift+→** | 1 second back or forward |
| **Shift+↑** | Jump to the start |
| **Shift+↓** | Jump to the end, or the selected camera's last keyframe |
| **Alt+↑** / **Alt+↓** | Zoom the Timeline in or out |

## Animate with keyframes

A keyframe locks the position and rotation of a camera or an object at one frame.

### 1. Turn on Auto-keyframe

Select the camera or object. Under **Transformation**, turn on **Auto-keyframe**. Spark places a keyframe at the playhead.

![The Transformation section. Box 1 is on Auto-keyframe, switched on, 2 on Delete Keyframe and 3 on the interpolation menu.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/setups-cameras/auto-keyframe.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=5c0e6f0d13272f8d892cb5a4ccd132a5)

1. **Auto-keyframe**
2. Keyframe button
3. Interpolation

### 2. Move the playhead

Press **Shift+→** to move 1 second later.

### 3. Change the position

Enter a new **Position** or **Rotation**. Spark adds a keyframe at the playhead.

![The Position section, with a box on its X, Y and Z fields.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/setups-cameras/position-fields.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=e649f957f5cd1c84e61ad2c2e4bd16ea)

The keyframe button reads **Place Keyframe**, or **Delete Keyframe** when the playhead is on one. The menu beside it sets how the move eases between keyframes, such as **Smooth**.

## Add a pre-animated USD clip

A USD file with its own animation brings it in as a clip. When you upload it, **Object Settings** shows the animation's length.

### 1. Add the object

Add it to the setup like any object. See [Add an object](https://docs.lightcraft.pro/spark/scene-editor/objects.md#add-an-object).

### 2. Add the clip

Expand the object's row in the Outliner. Move the playhead to where the clip starts, then click **+** on the **Animation** row.

![The Outliner with p5-sliding-box expanded. Box 1 is on its row and 2 on the plus button of its Animation row, 2.0s long.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/setups-cameras/animation-node.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=a30461ea893c7b196a91e941441a9e84)

1. Object row
2. **Add to timeline at playhead**

The clip shows on the object's Timeline row. Its properties gain **Animation**, with **Remove Animation**.

## Move a clip

Drag a clip along its row to start it at another time. Dragging an end moves the whole clip, so clips can't be trimmed here. To trim a sound, see [Add audio](https://docs.lightcraft.pro/spark/scene-editor/audio-locators-and-rulers.md#add-audio).

![Timeline rows for p5-sliding-box and Camera 2, with a box on the p5-sliding-box clip, moved to start later.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/setups-cameras/clip-moved.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=1a460ad80d26a7c36755da7c9fdeaf6d)

You can also drag a camera recording, such as one from **Direct Drive**, to a new time. **Ctrl+Z** puts it back. If the move overlapped keyframes and you clicked **Delete & Move**, the same undo brings those keyframes back.

## Related

> [card] [Cameras](https://docs.lightcraft.pro/spark/setups-cameras/cameras.md)
>
> Add a camera and set its lens.

> [card] [Objects](https://docs.lightcraft.pro/spark/scene-editor/objects.md)
>
> Add and move objects.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.