Getting Started
This page gets you from a blank project to your first animated composite.
Watch: 15-minute quickstart
A guided tour of the interface and building a simple project from scratch — the fastest way to get oriented. The written walkthrough below covers the same ground.
Install
Download Caddis for macOS from caddis.app. Open the app and create a new project — Caddis scaffolds a project folder with renders/, cache/, and generated/ subfolders alongside your .caddis file.
The interface at a glance
Caddis is organized around a few panels:
- Viewer — the canvas. Shows the rendered frame, gizmos, and on-screen tools. See Canvas Navigation for pan / zoom and viewport modes.
- Timeline — layers, clips, keyframes, and the playhead. It has Layers, Dope Sheet, and Graph Editor modes. See Timeline.
- Node Graph — the graph behind the active layer. Add nodes from the context menu and wire them together.
- Properties — parameters for the selected node or layer, with keyframing.
- Assets — images, video, and audio you've imported. See the Assets Panel.
Your first scene
- Create a composition. Set its resolution, frame rate, and duration.
- Add something to animate. Use a shelf tool — press R for a rectangle, O for an ellipse, or T for text — and draw on the canvas. Caddis creates a layer with a ready-made node chain (geometry → transform → draw → output). Or drag an image from the Assets Panel onto the canvas.
- Open the node graph. With the layer selected, look at its graph. Each node is one step in producing the layer's image. Add an effect — for example a Blur or Glow — from the context menu; if auto-wire is on, it connects automatically.
- Animate it. Move the playhead, then drag the transform gizmo or edit a value in Properties. With auto-key on, Caddis sets keyframes for you. Refine the timing in the Dope Sheet or Graph Editor.
- Preview. Scrub the timeline, or use RAM Preview (Numpad 0) for full-quality cached playback.
- Export. Open the Export dialog and choose a preset — image sequence, gif, EXR, or video (H.264 / ProRes / WebM).
Next steps
- Introduction — the concepts behind the timeline + node model.
- Node Reference — browse every node by category.
- Motion Tracking — track footage for match-moves and screen replacements.
- Recipes — reusable presets and starting points.
- Keyboard Shortcuts — the full list.