Appearance
Importing from After Effects
Bring an After Effects composition into Caddis — its layers, keyframes, eases, masks, shapes, text and nested comps — and keep animating it here.
It takes two steps: the Caddis panel in After Effects writes the composition to a file, and Caddis imports that file.
1. Export from After Effects
Install Caddis for After Effects. In the Caddis panel, ⋯ › Export Comp to Caddis… writes the open comp, and every comp it nests, to a .caddis-ae.json file. Export Selected Layers to Caddis… writes only the selected layers and what they need to render: their parents, track mattes, and layers their effects read.
Before anything is written, the panel lists what will come across and what won't. This includes expressions that will be baked, effects with no Caddis equivalent, third-party effects, lights and missing footage. Tick Copy footage next to the export to copy every footage file into a folder beside the export. Press Export… and choose where to save. When it's done, Open in Caddis imports it straight away.
The export only reads your project. It never changes it.
2. Import into Caddis
File › Import After Effects Export… and pick the file — or open the .caddis-ae.json from the Finder. The composition (and every comp nested inside it) is added to the open project as new compositions and opens in the timeline. One Undo takes the whole import back out.
Anything that didn't come across is listed in the Status Console, layer by layer.
What comes across
| After Effects | In Caddis |
|---|---|
| Footage (images, video) | Image Source / Video Source, added to Assets |
| Solids | Rectangle → Draw Shape |
| Precomps | Comp Source, pointing at the imported nested comp |
| Shape layers — rectangles, ellipses, stars/polygons, paths, fills, strokes, Trim Paths, group transforms | Rectangle / Ellipse / Editable Shape → Trim Path → Draw Shape |
| Text layers | Text → Draw Text (font, size, tracking, leading, alignment, fill, stroke) |
| Text animators — a Range Selector (Square, Ramp Up, Ramp Down; by character, word or line) moving Position, Scale, Rotation, Opacity or Blur | Text Animate, with the selector's keyframes as its Progress keys |
| Adjustment layers | Adjustment Source |
| Transform — anchor point, position, scale, rotation, opacity | Transform 2D + the Output's opacity |
| Keyframes, including eases (speed + influence), holds and curved motion paths | Keyframes with matching bezier handles and spatial tangents |
| Parenting and Nulls | Caddis parenting — the same as the timeline Parent column: Nulls come in as Caddis Nulls, and each child's own keyframes become its Parent offsets. Animate the parent once and every child follows. |
| Expressions | Baked: one keyframe per frame, exactly as After Effects evaluated it |
| Masks (Add, or a single Subtract; inverted; feather) | Editable Shape → Draw Shape → Matte |
| Track mattes (alpha, luma, and their inverted versions) | The layer's track matte |
| Blend modes Caddis has | The Output's blend mode |
| Blur & sharpen — Gaussian Blur, Fast Box Blur, Directional Blur, Channel Blur, Camera Lens Blur, Sharpen, Unsharp Mask | Blur, Sharpen |
| Color — Levels, Exposure, Brightness & Contrast, Hue/Saturation, Color Balance (HLS), Vibrance, Black & White, Tint, Tritone, Threshold, Posterize, Invert, Fill | Levels, Color Correct, Colorize, Threshold, Posterize, Invert, Solid Color + Matte |
| Keying & mattes — Color Key, Linear Color Key, Keylight, Simple Choker, Matte Choker, Set Matte | Keying, Choke, Layer Source + Matte |
| Distort — Corner Pin (including tracker / Mocha corner pins), Optics Compensation, Displacement Map | Corner Pin, Barrel Distortion, Layer Source + UV Remap |
| Generate & stylize — Gradient Ramp, Fractal Noise, Glow, Drop Shadow, Find Edges, Roughen Edges, Add Noise, Mosaic, Echo, Posterize Time, CC Vignette | Gradient, Noise, Glow, Drop Shadow, Edge Detect, Roughen, Grain, Mosaic, Echo, Posterize Time, Vignette |
| Layer styles — Drop Shadow, Inner Shadow, Outer Glow, Inner Glow, Color Overlay | Drop Shadow, Inner Shadow, Inner Glow, Solid Color + Matte |
| Effects on shape and text layers | After the layer's transform, as in After Effects (a blur keeps its size when the layer scales) |
| Effects stopping at a footage, solid or precomp layer's edge | A Crop labeled Layer Bounds after the effects (delete it to let a blur spread) |
| Layer in/out points, start time, motion blur switch | The clip's range, offset and motion blur |
| 3D layers — anchor point, position, scale, orientation, X/Y/Z rotation, with their keyframes | A Transform 3D before the Output: the layer as a card in depth |
| Cameras — one-node and two-node, zoom, depth of field, with their keyframes | A camera layer: Camera → Output |
| The Caddis effect (Caddis in After Effects) | Its node graph, where the effect sat in the layer's stack — see below |
Caddis layers
A layer carrying the Caddis effect comes back with its node graph: every node and wire, and every keyframe — the ones you set in Caddis and the ones on the effect's controls in After Effects, eases and baked expressions included — on the comp's clock. The nodes that read After Effects become their Caddis counterparts:
| In After Effects | In Caddis |
|---|---|
| AE Layer — This Layer | The layer's own image at that point of its stack (its footage, masks and the effects above Caddis) |
| AE Layer — another layer | A Layer Source of that layer. After Effects hands an effect a picked layer's source, without its transform, masks and effects; a Layer Source reads all of it, so the Status Console says when the two differ — precompose that layer in After Effects to get the same in both |
| AE Layer's Channel (Red, Luminance…) | A Shader node named after the channel, reading it exactly as AE Layer does |
| AE Mask | The masks as Editable Shape paths with their keyframes (merged when there are several), mask opacity as the paths' opacity |
| AE Shape | The shape layer's paths, each with its fill (or stroke) color, opacity and stroke width as Shape Attributes — before Trim Paths and the other path operators, as AE Shape reads them |
The graph arranges itself in the node graph like the rest of the import; the layout from the After Effects panel is not kept. A Caddis graph that ran on a layer smaller than the comp runs at the comp's size in Caddis, so generators that fill the frame (Noise, Gradient) cover the comp.
What doesn't (yet)
- Third-party effects and AE effects without a Caddis equivalent are left out and listed. (The Caddis effect comes across — see Caddis layers.)
- 3D: lights are skipped; Auto-Orient, 3D parenting and the 3D renderer's extrusion, bevels and environment light aren't converted, and a curved 3D motion path moves in straight lines between keys.
- Time stretch, time remapping, image sequences and audio layers.
- Text on a path, Source Text keyframes (the first text is used), and text animator extras: Tracking, Fill/Stroke color, Anchor Point, more than one animator or selector, Wiggly/Expression selectors. Randomize Order uses Caddis's own shuffle, so the order differs.
- Shape operators other than Trim Paths (Repeater, Merge Paths, Offset Paths, gradients…), animated star/polygon parameters, animated anchor points. A parent chain with an animated anchor point is baked (one key per frame) instead of parented.
- Intersect/Difference masks, mask expansion and mask opacity are dropped.
- Collapse Transformations on precomps.
- Blend modes Caddis doesn't have (e.g. Dancing Dissolve) fall back to Normal.
Fonts must be installed for text to match.
Motion tracking comes across through its results: After Effects' tracker and Mocha write keyframes onto a layer's Position / Anchor Point or onto a Corner Pin effect, and both import as keys.
Color effects in a normal After Effects project do their maths on display (gamma-encoded) values, where Caddis works in linear light. So those effects import between a To Display Gamma and a From Display Gamma Levels node, which reproduces the After Effects result. A project set to Linearize Working Space imports them without that wrapper.
How close is it?
Layer placement, keyframes and eases, parenting, expressions, time offsets, precomps, shapes, masks and mattes land within a pixel of After Effects — checked frame by frame against After Effects' own renders. A few things look slightly different by design:
- Transparency and blending. Caddis blends colors in linear light, so a layer at partial opacity, a soft edge, or a Screen/Overlay blend looks a little brighter than in a standard After Effects project. After Effects matches Caddis when Blend Colors Using 1.0 Gamma is on in Project Settings.
- Glow is Caddis's own glow with the closest settings; After Effects' Glow brightens the source itself more strongly.
- Approximations: Fractal Noise (a different noise pattern), Keylight / Color Key / Linear Color Key (same key color; tune Tolerance and Softness), Black & White (a plain desaturate), Hue/Saturation and Color Balance (a slightly different hue rotation), Tint / Tritone (slightly different brightness weighting), Matte Choker, Vibrance, angled Directional Blur.
- Not converted: Curves (After Effects doesn't expose its curve to scripts), Extract, Radial / Linear Wipe, Radial Blur, Bulge, CC Lens, and the Stroke, Bevel, Satin and Gradient/Pattern Overlay layer styles.
- Mosaic blocks are the same size, but Caddis lines its grid up with the composition rather than the layer, so block edges can fall differently.
- Optics Compensation is fitted to Barrel Distortion from After Effects' own lens curve — within a pixel or two at typical field-of-view values, looser above 90°.
- Text uses the same font, but the two apps space letters slightly differently (a few percent on long lines).
Tips
- Expressions arrive as one key per frame. They play back exactly, but are harder to edit; convert them to keyframes in After Effects first (or keep the expression's look and rework it in Caddis).
- Shape and text layers come in as live shapes and text, so you can keep editing them — but scaling a shape layer up a lot softens it, because its layer transform applies after drawing. Move the Transform 2D before the Draw Shape to keep it sharp.