Create a custom effect manually

Use the effect editor to import custom effect code and controls, then publish the effect to your project's Library. You can write the code, use an effect from a colleague, or ask an external AI assistant to create it.

If you'd rather describe the effect you want and have Sequence build it in place, ask Snippy instead — see Create a custom effect with Snippy.

Choose a video or audio effect. A video effect can modify the source image or generate an image independently, such as a background or wipe. Audio effects process sound, such as adding tape echo or a telephone filter. The steps below apply to both types.

Open the effect editor#

  1. Select a clip on the timeline and open the Effects tab in the Inspector.
  2. Open the Library sub-tab, next to Applied in the tab bar. The Library lists every custom effect in the project.
  3. Click the + button in the Library header, then choose the kind of effect you're building: Video effect for picture, Audio effect for sound. Sequence opens the effect editor, set up for that kind.
  4. Click the name field at the top of the editor — it defaults to "New Effect" (or "New Audio Effect") — and type a name.
The Library sub-tab with the plus button's menu open, offering Video effect (GLSL) and Audio effect (OpenCL).
Choosing the kind of effect to create.

The kind is fixed at creation

An effect's kind is locked by its first published version. If you picked the wrong one, create a new effect rather than trying to convert this one.

Bring in the effect as JSON#

You provide the effect and its controls together, bundled as a small block of JSON: your effect code and the controls you want to expose. Click the JSON button near the top-right of the editor to open the Import / Export JSON panel, then do either of the following:

  • Paste in a bundle you already have. Paste it into the text area and click Apply JSON. The editor fills in from the bundle.
  • Have an outside assistant write it. Click Copy LLM Prompt. That copies a prompt describing the exact bundle format Sequence expects. Paste it into Claude, ChatGPT, or whichever assistant you use, along with a description of the effect you want. Copy the JSON it replies with, paste it into the same text area, and click Apply JSON.

You can also export the current effect as JSON to share it or revise it with an assistant.

Define the controls#

Define the controls users can adjust after applying the effect. For each control, specify:

  • Name — matches the control to the value it drives in your effect. A video shader and its controls share these names, so a control named intensity drives the shader's intensity value. Audio effects address their controls by position instead, so an audio control's name is a label for you — hyphens are allowed, as in base-hz.
  • Label — the name that shows in the Inspector (for example, "Intensity").
  • Type — a number, a color, or an on-off. Audio effects take numbers only (whole numbers or decimals); the editor offers only those types once the effect's kind is audio.
  • Control style — a slider, a knob, a color picker, or a switch.
  • Range and default — the lowest and highest value the control accepts, and the value it starts at.
  • Group — an optional heading the control sits under in the Inspector, for organizing related controls together.

Video and audio bundles use the same JSON structure, with code in shaderProgram. This example defines a number slider and a color picker under a "Look" heading:

{
"shaderProgram": "<your shader code>",
"inputs": [
{
"name": "intensity",
"label": "Intensity",
"uniformType": "float",
"inputHint": "slider",
"min": 0,
"max": 1,
"defaults": [0.35],
"group": "Look"
},
{
"name": "tint",
"label": "Tint",
"uniformType": "vec3",
"inputHint": "color_picker",
"min": 0,
"max": 1,
"defaults": [1.0, 0.75, 0.45],
"group": "Look"
}
]
}

Animate a custom effect

Every control you expose is an ordinary Sequence property. To animate the effect over time, arm a control for keyframing and change its value across the clip, exactly as you would Position or Opacity. See Keyframe animation.

Publish and validate#

  1. Click Publish v1 at the bottom-right of the editor.
  2. Sequence validates the effect. A green "passed" confirmation means it's ready to apply; a red report lists what to fix. For an audio effect, Sequence also runs the effect against test tones and reports any behavioral checks it fails — for example, a filter that rings out of control or that isn't consistent from one playback to the next. Advisory checks appear alongside a passing result; they don't block publishing.

Your effect now appears in the Library with a v1 badge, an audio or video kind label, and a green status dot, ready to apply to any clip.

The Effects tab's Library sub-tab, where each published custom effect shows its name, a one-line description, an AUDIO or VIDEO kind label, a version badge, and a green validation status dot.
Your published effect in the Library, ready to apply.

Versions are kept

Each time you publish, Sequence adds a new version and keeps the old ones, so you can revert to an earlier one. The version badge on the Library row tracks the current version.

Apply the effect#

Once the effect is published and validated, add it to a clip from the Applied sub-tab — see Apply the effect to a clip.

Was this page helpful?