Appearance
Caddis in After Effects
Run Caddis node graphs on After Effects layers. The Caddis panel puts the node graph and Properties inside After Effects; the Caddis effect renders the graph in your comp, in the Render Queue, at every bit depth — and its animation is plain After Effects keyframes.
What you need
- Caddis 1.1.1 or later, installed on the same computer. The plug-in uses that copy of Caddis — its engine, its panel and your license — and updates whenever Caddis does.
- After Effects 2025 or later, on macOS or Windows.
Install
- In Caddis, open Settings › After Effects (Preferences on Windows) and click Install.
- Restart After Effects.
- Open the panel from Window › Extensions › Caddis and dock it wherever you like.
On Windows, quit After Effects before you install or update, and choose Yes when Windows asks for permission: the effect goes into a plug-ins folder all Adobe apps share, which needs an administrator. Windows asks again only when the effect itself changes.
When Caddis updates, it updates the plug-in too; restart After Effects to load the new version.
Put Caddis on a layer
Select a layer and click Apply to layer in the Caddis panel (or use Effect › Caddis › Caddis). The panel opens the layer's graph, which starts as AE Layer → Output — the layer as it was. Add nodes between the two.
On an adjustment layer, AE Layer is the composite of every layer below it, as for any effect there: put Caddis on an adjustment layer and add a Draw ASCII between the two to turn everything beneath it into type. On a plain solid the graph starts empty — a canvas for a graph that makes its own pictures.
New Caddis Layer makes a comp-sized layer that is only Caddis — for a graph that generates everything itself (shapes, particles, text, noise).
The panel follows After Effects: select a layer with Caddis and its graph opens, and deselect it or switch to another composition and it closes; scrub the timeline and Properties follows the time. With several Caddis effects on one layer, select the one you want in Effect Controls.
Effects above Caddis in Effect Controls run first, so Caddis sees their result; effects below it see Caddis's.
Edit
The node graph and Properties work the way they do in Caddis — add nodes with right-click or Tab, wire ports, drag values; scroll to zoom the graph and middle-drag to pan it. Every change is one After Effects undo step: Cmd+Z undoes it in the panel and in After Effects alike, and the graph saves with your After Effects project.
Layout
Vertical puts the graph above Properties, so a chain reads left to right across the panel's whole width. Horizontal puts Properties beside the graph, for a wide panel. Auto (the default) uses Horizontal when the panel is wider than it is tall and Vertical otherwise; pick one from the layout button at the right end of the shelf to keep it. Drag the line between the graph and Properties to share the space; in a panel too small for both, they take turns as tabs.
The shelf
The shelf above the graph holds:
- Align — moves the graph's content to the left, right, top, bottom or center of its own layer, through the layer's main Transform 2D (one undo step). To line up several layers, use After Effects' Align panel.
- Color tokens — the same named colors as in Caddis. Drag a swatch onto a color parameter or a gradient stop to link it; change the token's color and every parameter linked to it follows, on every Caddis layer in the After Effects project. The tokens are saved with the After Effects project. + Color adds one; click a swatch to edit, rename or delete it.
- Eyedropper — the eyedropper in a token or color picker picks a color from anywhere on screen, After Effects' Composition viewer included. It reads the color as your screen shows it, so on a linear or OCIO project the picked color is close to the value in the comp, not exact.
To draw a shape or a mask, use After Effects' own Pen, Rectangle and Ellipse tools, then bring what you drew into the graph with AE Mask or AE Shape (Masks and shape layers): the paths stay live, so redrawing them in After Effects updates the graph.
The node menu opens on AE, and drag a wire out of an image input and AE Layer is the first suggestion. The menu offers what an After Effects layer can run. The nodes that read the rest of a Caddis project are AE Layer here: its Layer menu picks any layer, and on an adjustment layer it is the composite below — so Adjustment Source, Layer Source and Comp Source are not offered. Sound is After Effects' own, so Audio Mix and the audio ports are hidden (Audio Source still drives values from a file). Planar Track, Track Points and File Cache, which read or bake a whole range of frames, are not offered yet — use After Effects' tracker and its cache.
While the panel has focus it keeps the keys a node editor needs (Delete, Cmd+C / V / D, letters). Space still plays your comp, and ~ still maximizes the panel.
A graph you open is framed for you, at a size you can read: a long chain that doesn't fit shows its Output end. Press F to see every node. Switch to another layer and back, and the panel keeps your view of each graph.
Animate
Animation lives in After Effects. Click a parameter's keyframe diamond in Properties and Caddis adds that parameter to the Caddis effect in Effect Controls — named after its node, like Circle: Radius — with a keyframe at the current time. From then on it is an ordinary After Effects property:
- move keys, change eases, and use the Graph Editor in the timeline;
- add expressions, or pick-whip it to anything;
- the diamonds in Properties show where its keys are, and editing the value in Properties keys it at the current time.
Each parameter becomes the control you would expect: rotation an angle dial, opacity a percent slider, a position a point with a crosshair in the viewer, a color a swatch, a toggle a checkbox, other numbers sliders (a vector you have unlinked becomes one slider per axis).
Gradients, curves, text and paths have no After Effects control; they keep their keyframes inside the graph.
A Caddis effect can animate up to 64 numbers and 16 each of points, angles, colors and checkboxes. Rename a node and its After Effects controls follow; delete it and they go away.
Read other layers
The AE Layer node brings a layer's pixels into the graph. Its Layer menu picks This Layer (the one the effect is on) or any other layer in the comp — for a displacement map, a matte, a texture. The pick is an After Effects layer menu on the effect, so After Effects knows the effect depends on that layer and re-renders when it changes; you can change it from Effect Controls too. Hide the source layer (its eye) if you only want it as an input. A Caddis effect can read up to 8 other layers.
Its Channel menu uses the layer as it is (RGBA) or one channel of it as a gray image — Red, Green, Blue, Alpha, Luminance or Lightness — like the channel menus on After Effects' own effects: a layer's Alpha into a Matte cuts with its shape, its Luminance into a displacement pushes with its brightness.
Like the Layer menus on After Effects' own effects, a picked layer arrives as its source, without its own masks and effects. To read it with them — including another Caddis effect — precompose it and pick the precomp.
Masks and shape layers
AE Mask brings a layer's masks into the graph as Caddis paths, with After Effects' own curves: every mask, or one by its number in the Mask menu. Masks set to None come through too, so a path kept only for effects works here. AE Shape brings a shape layer's contents — its paths, rectangles, ellipses and stars, through every group's transform — each path carrying the color After Effects fills or strokes it with, so Draw Shape redraws the layer in its own colors. Pick the layer in Layer, as for AE Layer: This Layer, or any layer in the comp (for AE Shape, any shape layer).
The paths sit where the masks and shapes sit on their layer, lined up with the same layer's AE Layer image, and they are read at every frame Caddis renders: a mask you animate, track or drive with an expression moves in the graph too. Draw a mask, then stroke it with Draw Shape, trim it on with Trim Path, or emit particles along it with a Point Emitter. Time Shift, Echo and the nodes that replay their history read the masks at the frames they need.
Text layers
AE Text brings a text layer in as Caddis text — the same kind the Text node makes — so Text Animate, Text to Shape, Text to Points and Draw Text work on type you set in After Effects. Pick the text layer in Layer (This Layer when Caddis is on the text layer itself). The words are read at every frame, Source Text keyframes and expressions included; the font, size, tracking, leading, alignment, all caps, text box and fill color follow the text layer while the panel is open (each change arrives as one undo step, Match AE Text Style). Caddis lays the text out itself in the same font, so spacing can differ slightly from After Effects'. Per-character styling and After Effects' text animators are not carried. See AE Text.
Mask modes, feather and expansion are not applied to the paths (each mask arrives as its own path, and its feather and expansion as attributes), nor are a shape layer's Trim Paths, Repeater and other path operators, gradient fills or group skew. A picked layer's own transform is not applied, as with AE Layer. See AE Mask and AE Shape.
Time effects on After Effects layers
Time nodes read an After Effects layer at the frames they ask for: Echo, Time Shift, Freeze Frame, Posterize Time and Loop Time on an AE Layer work as they do in Caddis, in the viewer and the Render Queue. Before the layer starts, or after it ends, the layer is empty at those frames, as it is in After Effects. Up to 32 other frames of a layer go with each frame Caddis renders; any more it asks After Effects for while it renders.
Optical Flow on an After Effects layer — footage into Vector Motion Blur, say — reads the frames before the one it renders: one with Temporal Smoothing at 0, up to nine with it on (each is a frame After Effects renders of that layer first, so smoothing off is the fastest). Every frame gets its motion, with multi-frame rendering on too.
Slitscan reads the frames its slices show, across its Frame Span (24 of them by default — fewer slices render faster).
Nodes that replay a layer's history work on After Effects layers too: Slitscan's Scan mode, a Solver — particles emitted from footage, pushed by its brightness, a feedback trail of the layer itself — Point Advect, Point Trail, a Point Emitter whose rate or source comes from the layer, Trigger, and Draw Instances offsetting its instances in time. While it renders, Caddis asks After Effects for each earlier frame its replay reaches — the layer just as Caddis sees it now, with its masks and the effects above Caddis (a picked layer as its source), and empty before the layer starts and after it ends — and keeps what it builds from them. Playing forward costs one frame of the layer at a time, and scrubbing back replays a short stretch (Caddis keeps a resume point every sixteen frames). The first frame you look at far into a long layer replays from the layer's start, once. Each resolution keeps a history of its own: switching the viewer between Full and Half and back costs nothing, and a draft preview never finds its way into a Render Queue render. Change the layer itself — its footage, an effect above Caddis, a keyframe at any time — and Caddis builds that history again, since every later frame may have changed with it. In the Render Queue every frame comes out as it does in Caddis.
If the node graph marks a node THIS FRAME, After Effects is still running the Caddis effect it loaded before Caddis was updated: that one hands Caddis only the frame being rendered. Restart After Effects to finish the update.
3D
In After Effects, a Caddis graph's 3D is seen through the comp's camera: models, points and shapes in depth, particles and 3D text follow the active camera layer, or After Effects' default view when there is none. They line up with your 3D layers and move with the camera, its depth of field and motion blur included. Put the effect on a 2D layer the size of the comp at its default position, as a new solid is: Caddis draws the camera's view onto it. Moving or scaling that layer moves the picture, not the 3D.
On a 3D layer, After Effects places the Caddis picture in its scene like any other layer, so Caddis draws its 3D with its own default view.
The comp's camera takes the place of the Camera node, so the node menu doesn't offer one. Caddis layers and After Effects 3D layers are combined in layer order, not by depth: a point in front of a 3D layer covers it only when its Caddis layer is above that layer. Place 3D things with their values in the Properties panel; the 3D gizmo is in the Caddis app's Viewer.
Open a Caddis project
In the panel, ⋯ › Open Caddis Project… turns a .caddis file into a folder of After Effects compositions. Before anything is created you see what will come across, and what will not come across exactly.
- Every composition becomes an After Effects comp; every layer an After Effects layer, at the same time and duration.
- Opacity (with its keyframes and eases), blend modes, track mattes, motion blur, and enabled/locked become After Effects settings.
- A layer that is just a nested comp becomes a precomp layer; a layer that is just an audio file becomes an audio layer.
- A nested comp with Caddis nodes after it (a glow on a precomp) becomes a precomp layer carrying a Caddis effect: After Effects renders the precomp, you can open and edit it there, and its sound plays.
- Audio keeps its timing — speed, start offset, loop, ping-pong and reverse come across as the layer's Time Remap — and its level. Sound through an Audio Mix plays on one After Effects audio layer per source, at the level the mix gives it (faders, master and crossfader, keyframed where they are).
- An animated blend mode splits the layer where it changes, as you would by hand. A graph that depends on where its layer starts (simulations, Slitscan, Freeze Frame) stays one layer with its first blend mode, and the summary says so.
- An adjustment layer stays an adjustment layer.
- A camera becomes an After Effects camera (two-node when it has a Target), with its zoom, depth of field and keyframes.
- A card, a layer placed in depth by Transform 3D, becomes an After Effects 3D layer carrying that transform and its keyframes. A card After Effects can't place the same way (effects after its Transform 3D, values wired into it, text or shapes turning around their own center) keeps its Transform 3D in the Caddis effect and still follows the camera.
- Models, points, particles and 3D text stay in a Caddis effect that sees through that camera (3D).
- Every other layer gets a Caddis effect with its graph, and its keyframes become After Effects keyframes.
- Blend Colors Using 1.0 Gamma turns on in the project's settings, so layers blend as they do in Caddis — a red layer at 50 % over blue mixes the way light does, not the darker way After Effects blends by default. It applies to every comp in the project; the confirmation says so first.
The whole conversion is one undo step, the blending setting included.
Send a comp to Caddis
The other way round: ⋯ › Export Comp to Caddis… writes the open comp — and every comp it nests — to a .caddis-ae.json file, with its keyframes, eases, masks, shapes, text and effects; Export Selected Layers to Caddis… writes only the selected layers and what they need (their parents, mattes, and layers their effects read). It is saved next to your After Effects project (Importing from After Effects lists what comes across). When it is done, Open in Caddis in the message bar imports it into the Caddis app — opening the file from the Finder does the same.
Layers carrying the Caddis effect come back with their node graph — every node, wire and keyframe, the keys on the effect's controls included. AE Layer, AE Mask and AE Shape become their Caddis counterparts (the layer's own image, a Layer Source, the masks and shape paths as Caddis shapes): Caddis layers lists how. 3D layers come back as Transform 3D cards and cameras as Caddis cameras; lights are left out.
Render
Caddis renders wherever After Effects does — the comp viewer, RAM preview, the Render Queue — in 8, 16 or 32 bits per channel, with multi-frame rendering. It follows the project's color settings: a linear working space (Linearize Working Space, or a linear profile like ACEScg) or OCIO color management with a scene-linear working space (ACEScg, After Effects' default) and Caddis works in linear light as After Effects does; otherwise it blends as it does in the Caddis app, in linear light, and hands back encoded values. Under OCIO, Caddis takes the working space to be scene-linear — After Effects does not tell plug-ins which one is chosen — so a log working space such as ACEScct is not supported. At half, third, quarter or a custom resolution it renders at that size. If a frame cannot be rendered for a moment (the engine is starting or restarting), After Effects asks for it again rather than keeping an empty frame.
License
The plug-in uses your Caddis license: sign in from the Caddis app and After Effects renders clean. During a trial you see how many days are left in the panel. Without a license, or once a trial has ended, renders carry a watermark — the panel and Effect Controls say so, and nothing else changes.
Caddis checks the license in the background, so you rarely need to open it; if the panel shows Watermarked, open Caddis once to sign in. When the license changes, frames After Effects has already cached render again under the new one within a few seconds, whether or not the panel is open.
Color
Caddis renders in your project's color settings. With OCIO color management on in ACEScg (After Effects' default for OCIO), Caddis renders in ACEScg, as a Caddis project set to ACEScg does. Other OCIO working spaces (ACES2065-1, linear P3 or Rec.2020) render in Linear Rec.709: pixels and color parameters pass through unchanged, but color effects that depend on the gamut (Color Blend, Perceptual Invert, Color Space) assume Rec.709 primaries. Log working spaces such as ACEScct are not supported yet.
Plugins
Plugins you install in Caddis work in After Effects too: their nodes are in the panel's node menu under Plugins, and they render in the viewer and the Render Queue. Install, update, switch off and license plugins in the Caddis app (Plugins › Manage Plugins). After Effects follows within a few seconds, and frames it had cached with the old plugins render again. A paid plugin that runs as a trial in Caddis runs as a trial in After Effects.
Anyone opening your After Effects project needs the same plugins installed in their Caddis. Without one, its node renders nothing and is marked MISSING in the panel, as in Caddis.
Share projects
Anyone opening your After Effects project needs Caddis installed — any license state; without a license their renders are watermarked. A graph made with a newer Caddis than theirs shows update Caddis instead of rendering wrong, and opens read-only in the panel. To hand a project to someone without Caddis, select a Caddis layer and choose ⋯ › Bake Layer to Footage in the panel: After Effects renders it with alpha through the Render Queue and swaps the footage in. The graph stays in a precomp named after the layer, so you can switch back. Bakes are saved in a Caddis Bakes folder next to your project.
Troubleshooting
- Effect Controls says "Caddis is not installed" — install Caddis, or open it once so it can tell the plug-in where it is.
- The panel says it can't reach After Effects — reinstall the plug-in from Settings › After Effects, then restart After Effects.
- No Caddis under Window › Extensions — restart After Effects after installing.
- Logs:
After Effects.log(the effect) andAfter Effects engine.log(the engine), in~/Library/Logs/Caddison macOS and%LOCALAPPDATA%\Caddis\logson Windows.