Beta 0.901beta

The rack.

Click a module to open its faceplate, ports, and starting patch.

Video Float / CV Audio

88 written entries · snapshot 2026-09-02

Sources

Open row

Solid Color

Video File

Image File

Image Seq

3D Model

Morph3D

Camera

Syphon Input

NDI Input

Shape

Lines

Noise

Gradient

Checker

TV Static

Text

Plasma

Cellular

VideoSynth

Wave Field

Moiré

Pulse Grid

Sykora

Geometr

LiveCode

ISF

Wireframe

Radiant Pack

Particles

Voronoi

Starfield

Clrmchnx

Spirograph

Audio Visualizer

Effects

Open row

Transform

Blend

Pixellate

Pixel Sort

Mirror/Kaleido

Color Adjust

Blur

Glitch

Feedback

Chroma Key

Motion Trace

Zoom Blur

Chromatic Trails

Edge Detect

Posterize

Optical Flow

Interest Mesh

ASCII/Halftone

Dot Screen

Delay Buffer

Multiply

Echo

Perispheric

Fish Eye

Wave $Refraction faceplate$ Refraction

Crystal Distortion

Reality Fold

Glow

Hula

Time Slice

Crop

LUT

Sample & Hold

Modulators

Open row

LFO

Audio Follow

Freq Follower

Timeline

Step Seq

Random $Math faceplate$ Math

CV Util

CV+

Macro

Cable Receiver

Mix / Output

Open row

Mixer 4

Mixer 8

Mixer 16

CV Split

V-Split

Oscilloscope

Output

Partial Output

Group

Guide

Patchframe signal basics

Patchframe is a modular visual system. You build a patch by placing modules and connecting compatible ports with patch cables. A simple first patch is a visual source connected to an effect, then connected to Output.

Video

A video signal is a moving picture on a cable. Sources create it, effects transform it, mixers combine it, and Output shows or sends it. It can come from a file, a camera, a live feed, or a generated image.

CV

CV means control value. It is a number that can change over time—for example, a slow wave, a random value, or the strength of a beat. CV is not a picture and is not sound you hear. It is used to move a parameter, select a level, or carry an analyzed value between modules.

Audio analysis and control values

Audio-reactive modules listen to microphone, line-in, or another supported audio source and measure qualities such as loudness or frequency energy. They can turn those measurements into CV for visual control. Patchframe can also carry stereo audio frames between compatible audio ports, allowing modules to pass, analyze, or send audio alongside visuals. Audio and video remain separate signal types.

Triggers

A trigger is a brief event meaning carried on a float/CV port, often as a change from a low value to a high value. Use one when something should happen once, such as advancing a step, restarting motion, or firing an action. A trigger is not a separate cable type: trigger-labelled and ordinary CV ports carry the same kind of numeric signal, so they are compatible where a module is designed to interpret that signal as an event.

Ports and patch cables

Ports are the labeled connection points on a module. An input receives a signal; an output sends one. A patch cable joins an output to a compatible input. Patchframe has three connection types: video, float/CV, and audio. “Trigger” describes how a float/CV value is used, not a fourth connection type. If a cable is refused or produces no result, check both port types and whether the upstream module is producing a signal.

Parameter modulation

Modulation lets a CV output move a parameter automatically. Connect the CV output to that parameter’s CV input; the incoming value is limited to 0…1 and mapped across the minimum and maximum set by the control’s bracket markers. With + polarity, CV rises from the bracket minimum toward the maximum. With − polarity, that mapping is reversed. Narrow the bracket range for subtler movement, and use polarity to choose the direction.

Feedback safety

Feedback sends an earlier result back into the patch so frames build on one another. It can create rich trails, but it can also become bright, unstable, or visually intense very quickly. Begin with conservative blend or feedback amounts, keep a direct way to reach Output, and be ready to disconnect the feedback cable or bypass the relevant module. Take extra care around flashing imagery.

Output

Output is the final destination for the main picture. Connect the video you want viewers to see to Output. A patch is intended to have one Output module, so the Add Module picker offers it only when the graph does not already contain one. Utility outputs and external sending modules may have different purposes; their entries will call that out.

Guide

How to read module entries

Each completed module entry follows the same pattern:

Inputs tables name each incoming port, its signal type, and what it accepts.
Outputs tables name each outgoing port, its signal type, and what it provides.
Controls tables show the control name, starting default, allowed range or choices, adjustment step when one matters, and the visible effect.
Defaults are the module’s starting settings. A loaded patch can store different values.
Ranges, options, and steps describe what the current Beta allows. A range gives its endpoints; options list named choices; a step is the smallest normal adjustment.
Dynamic ports are created or rebuilt from the module’s current content. Modules such as ISF, LiveCode, Group, and Macro may therefore show different ports from one patch to another; their entries describe the rule instead of claiming one fixed layout.
Work-in-progress notes identify known uncertainty, external requirements, permissions, timing, performance, or safety considerations without guessing.
Existing faceplates are included where available. They are orientation aids; the tables and notes describe the current behavior.

Guide

Compatibility / Availability

The sections below keep older or non-picker module types separate from modules that testers can add normally. They are not part of the 88-entry main guide index. Wireframes are intentionally omitted here because these are availability records, not supported module entries.

Legacy / preset-only registry entries

Patchframe recognizes these raw type identifiers when restoring older files, but does not offer them for newly added modules.

Raw type	Restored as	Current behavior
<a id="legacy-gaussian-blur"></a>`gaussianBlur`	Blur	Loads the current Unified Blur implementation.
<a id="legacy-blur-mps"></a>`blurMPS`	Blur	Loads the current Unified Blur implementation.
<a id="legacy-blur-multi"></a>`blurMulti`	Blur	Loads the current Unified Blur implementation.
<a id="legacy-motion-blur"></a>`motionBlur`	Motion Blur	Still recognized and can instantiate the older module, but the type is disabled in this Beta build.
<a id="legacy-cellular-a"></a>`cellularA`	CellularA	Compatibility placeholder: currently restores as Solid Color until a dedicated CellularA path exists.
<a id="legacy-audio-follower"></a>`audioFollower`	Audio Follower	Renamed alias that loads the current Audio Follow implementation.
<a id="legacy-perlin"></a>`perlin`	Noise	Loads the current Noise module in Perlin mode.
<a id="legacy-perlin-noise"></a>`perlinNoise`	Noise	Loads the current Noise module in Perlin mode.
<a id="legacy-boids"></a>`boids`	Boids	Compatibility placeholder: currently restores as Solid Color until a Boids module exists.
<a id="legacy-osc-input"></a>`oscInput`	OSC In	Still recognized for old files, but disabled in this Beta build.
<a id="legacy-osc-output"></a>`oscOutput`	OSC Out	Still recognized for old files, but disabled in this Beta build.

Do not use these identifiers as a way to add hidden modules. The placeholder mappings preserve file loadability, not the original visual behavior.

Registered and enabled, but not in the Add Module picker

These types have current registrations and are enabled by the Beta configuration, but are absent from the normal Add Module picker. They may occur in restored files or development-created graphs; their presence here is not a promise that they are ready for normal patch authoring.

Raw type	Display name	Availability note
<a id="non-picker-reaction-diffusion"></a>`reactionDiffusion`	Reaction-Diffusion	Registered and enabled; not addable from the normal picker.
<a id="non-picker-chroma-key"></a>`chromaKey`	Chroma Key	Registered and enabled; separate from the picker-facing `keying` Chroma Key type.
<a id="non-picker-slew-limiter"></a>`slewLimiter`	Slew	Registered and enabled; not addable from the normal picker.
<a id="non-picker-dmx-output8"></a>`dmxOutput8`	DMX Out 8	Registered and enabled; not addable from the normal picker. Requires compatible DMX hardware and configuration when restored or created by development tooling.
<a id="non-picker-dmx-output12"></a>`dmxOutput12`	DMX Out 12	Registered and enabled; not addable from the normal picker. Requires compatible DMX hardware and configuration when restored or created by development tooling.

Picker-listed, but disabled in the Beta target

There are no modules in this availability bucket in the 2026-09-02 snapshot: every static picker entry is enabled for this Beta target.

Retired enum-only module types

These identifiers remain in the application’s type list so old serialized data can be recognized, but they have no current registry implementation and are explicitly retired. They are disabled even if an older module flag suggests otherwise.

Raw type	Former display name	Current status
<a id="retired-branches"></a>`branches`	Branches	Retired and unsupported.
<a id="retired-multi-band-follower"></a>`multiBandFollower`	Multi Band Follower	Retired and unsupported.
<a id="retired-lissajous"></a>`lissajous`	Lissajous	Retired and unsupported.
<a id="retired-stereo-xy"></a>`stereoXY`	Stereo XY	Retired and unsupported; retirement takes precedence over its stale enabled-module flag.
<a id="retired-flow-field"></a>`flowField`	Flow Field	Retired and unsupported.

Guide

Module bug-reporting checklist

A short, reproducible report is the most useful. Please include:

the module name and Patchframe version shown in the app;
the relevant source, effect, modulation, and Output connections;
numbered steps that reproduce the problem from a new or attached patch;
the expected result and the actual result;
whether it happens every time or only under certain timing or media conditions;
a screenshot, short recording, or visible error message when it clarifies the issue;
your macOS version, Mac model and graphics hardware, plus camera, audio, MIDI, network, or external-app details when relevant; attach a useful log excerpt when an error is recorded.

34 modules

Sources

Sources create an image, load media, or bring a live visual feed into a patch.

When an Inputs row contains several labels, every label is a separate jack. Parameter jacks accept normalized Float/CV (0–1) and map it across the control's displayed range unless noted otherwise.

Solid Color

Video File

Image File

Image Seq

3D Model

Morph3D

Camera

Syphon Input

NDI Input

Shape

Lines

Noise

Gradient

Checker

TV Static

Text

Plasma

Cellular

VideoSynth

Wave Field

Moiré

Pulse Grid

Sykora

Geometr

LiveCode

ISF

Wireframe

Radiant Pack

Particles

Voronoi

Starfield

Clrmchnx

Spirograph

Audio Visualizer

34 modules

Effects

Effects receive a video and change, analyze, delay, or combine it.

Parameter jacks accept normalized Float/CV (0–1) and map it across the control's current bracket range unless noted otherwise.

Transform

Blend

Pixellate

Pixel Sort

Mirror/Kaleido

Color Adjust

Blur

Glitch

Feedback

Chroma Key

Motion Trace

Zoom Blur

Chromatic Trails

Edge Detect

Posterize

Optical Flow

Interest Mesh

ASCII/Halftone

Dot Screen

Delay Buffer

Multiply

Echo

Perispheric

Fish Eye

Wave $Refraction faceplate$ Refraction

Crystal Distortion

Reality Fold

Glow

Hula

Time Slice

Crop

LUT

Sample & Hold

11 modules

Modulators

Modulators create changing control values that can animate parameters or respond to sound.

LFO

Audio Follow

Freq Follower

Timeline

Step Seq

Random $Math faceplate$ Math

CV Util

CV+

Macro

Cable Receiver

9 modules

Mix / Output

Mix and utility modules route signals, combine layers, inspect values, and send the finished picture onward.

Mixer 4

Mixer 8

Mixer 16

CV Split

V-Split

Oscilloscope

Output

Partial Output

Group

Sources

Solid Color

Produces a flat color video for backgrounds, masks, and color layers. The color can be set by channels or by the module's six-digit RGB hex field.

Inputs

Label	Signal	Purpose
`Red`, `Green`, `Blue`, `Alpha`	Float/CV	Modulate the matching color channel.

Outputs

Label	Signal	Purpose
`Out`	Video	Full-frame solid color.

Controls

Control	Initial value	Range / step or options	Purpose
`Red`, `Green`	0.2	0–1 / 0.01	Red and green channels.
`Blue`	0.8	0–1 / 0.01	Blue channel.
`Alpha`	1	0–1 / 0.01	Opacity.
Hex color	`#3333cc`	Six-digit RGB	Sets Red, Green, and Blue together; Alpha remains separate.

Starting patch

Connect Out to Output, then lower Alpha before compositing it over another source.

Notes

The module renders a compact color frame that the graph can scale efficiently; it is a low-cost source.

Sources

Video File

Plays a local movie, with transport, looping, sound, and framing controls. Choose a file in the module, then trim or scrub it without altering the original media.

Inputs

Label	Signal	Purpose
`Speed`, `Position`, `In`, `Out`, `Dir`, `Loop`, `Loop Mode`, `Volume`, `Scale`, `Pos X`, `Pos Y`	Float/CV	Drive the matching playback or framing control. Connected `Position` CV becomes a normalized frame scrubber between In and Out.

Outputs

Label	Signal	Purpose
`Out`	Video	Current decoded video frame.

Controls

Control	Initial value	Range / step or options	Purpose
File	No video	MOV, MP4/MPEG-4, QuickTime, AVI	Loads a movie, replacing the current selection.
`Speed`	1	0–2 / 0.01	Playback-rate magnitude; 0 pauses.
`Position`	0	0–1 / 0.001	Scrubs normalized position; a connected CV takes control and seeks rather than free-playing.
`In`, `Out`	0, 1	0–1 / 0.001	Normalized trim boundaries.
`Dir`	0	Forward (0), Backward (1)	Selects direction.
`Loop`	1	Off (0), On (1)	Enables looping.
`Loop Mode`	0	Repeat (0), Ping-pong (1)	Chooses loop behavior.
`Volume`	0	0–1 / 0.01	AVPlayer audio level; there is no Audio output jack.
`Scale`	1	0.01–4 / 0.01	Zooms the frame.
`Pos X`, `Pos Y`	0	−1–1 / 0.01	Offsets the frame.

Starting patch

Load a short MOV, connect Out to an effect and then Output, enable Loop, and try Speed 0.5.

Notes

Media is referenced by file path/security bookmark rather than embedded, so keep the file available when moving a patch. A missing or undecodable file produces black. Default framing aspect-fills and may crop. Reverse playback uses repeated seeks and can be less smooth or more expensive than forward playback.

Sources

Image File

Loads a still image and presents it as a video with simple position, scale, rotation, and flip tools.

Inputs

Label	Signal	Purpose
`Pos X`, `Pos Y`, `Scale`	Float/CV	Modulate image placement and zoom.

Outputs

Label	Signal	Purpose
`Out`	Video	Loaded and transformed image, or transparent output when cleared.

Controls

Control	Initial value	Range / step or options	Purpose
Image	None	PNG, JPEG, TIFF, BMP, HEIC	Loads or clears a still image.
`Pos X`, `Pos Y`	0	−1–1 / 0.01	Moves the image.
`Scale`	1	0.01–4 / 0.01	Zooms the image.
Rotate left/right	0°	0°, 90°, 180°, 270°	Rotates in quarter turns.
Flip H, Flip V	Off	Off, On	Mirrors horizontally or vertically.

Starting patch

Load a logo, connect Out to Blend, and use Scale and Pos X/Y to place it over a video.

Notes

The normal save path can embed image data, while the source also retains its file reference. Default framing aspect-fits, leaving transparent letterbox areas. Current source does not serialize the rotate/flip button state in the module's saved extra state; treat those three UI transforms as WIP and verify them after reopening a patch.

Sources

Image Seq

Plays a folder of still images as a flipbook, freely timed or locked to patch tempo, with several frame-transition styles.

Inputs

Label	Signal	Purpose
`Speed Mode`, `Rate`, `Beats Div`, `Transition`, `Trans Time`, `Wipe Dir`, `Offset`, `Ping Pong`, `Frame Idx`	Float/CV	Drive the matching playback control. A connected `Frame Idx` directly selects a normalized frame and cuts between frames.

Outputs

Label	Signal	Purpose
`Out`	Video	Current frame or transition result.

Controls

Control	Initial value	Range / step or options	Purpose
Folder	None	Folder picker; JPG/JPEG, PNG, TIFF/TIF, BMP, GIF, HEIC	Loads all recognized images in the chosen folder.
`Speed Mode`	Free	Free (0), BPM (1)	Selects frames-per-second or beat timing.
`Rate`	8	0.1–60 / 0.1	Frames per second in Free mode.
`Beats Div`	1 beat	1/8, 1/4, 1/2, 1, 2, 4, 8, 16	Beats per frame in BPM mode.
`Transition`	Cut	Cut, Dissolve, Flash, Dip Black, Wipe, Noise, Perlin, Glitch	Chooses the frame change.
`Trans Time`	0.3	0–1 / 0.01	Fraction of each frame interval spent transitioning; unused by Cut.
`Wipe Dir`	→ Right	→ Right, ← Left, ↓ Down, ↑ Up	Direction used by Wipe.
`Offset`	0	0–999 / 1	Rotates the sequence start index.
`Ping Pong`	Off	Off, On	Reverses at the sequence ends.
`Frame Idx`	0	0–1 / 0.001	Manual normalized selector only while its CV jack is connected.

Starting patch

Choose a numbered frame folder, connect Out to Output, set BPM mode to 1/2, then try Dissolve at 0.25.

Notes

Files are ordered by filename using localized natural sorting, so names such as frame2 precede frame10. The folder is bookmark-referenced, not embedded. Images load asynchronously into GPU memory; very long or high-resolution sequences can consume substantial memory. Output aspect-fills and may crop.

Sources

3D Model

Renders a local 3D scene or model into a video, optionally replacing its diffuse materials with an incoming video.

Inputs

Label	Signal	Purpose
`Texture`	Video	Optional replacement video for model materials.
`Rotate X`, `Rotate Y`, `Rotate Z`, `Zoom`, `Position X`, `Position Y`, `Light`, `Ambient`, `Wireframe`	Float/CV	Drive the matching camera, lighting, or rendering control.

Outputs

Label	Signal	Purpose
`Out`	Video	SceneKit-rendered model with transparent background.

Controls

Control	Initial value	Range / step or options	Purpose
Model	None	STL, OBJ, USDZ, USD, DAE, SCN, GLTF, GLB	Loads, drag-drops, or clears a model file.
`Rotate X`, `Rotate Y`, `Rotate Z`	0	0–1 turn / 0.01	Rotates each axis through 360°.
`Zoom`	0.5	0.1–50 / 0.01	Changes camera scale.
`Position X`, `Position Y`	0	−2–2 / 0.01	Moves the model in frame.
`Light`	0.7	0–1 / 0.01	Main-light strength.
`Ambient`	0.35	0–1 / 0.01	Ambient-light strength.
`Wireframe`	Off	Off (0), On (1)	Switches to line rendering.

Starting patch

Load an OBJ, connect a moving Noise video to Texture, connect Out to Output, and slowly modulate Rotate Y.

Notes

The model is stored as a path/security bookmark; companion materials and textures must remain available, normally beside the model. Disconnecting Texture restores original materials. Invalid or empty scenes render transparent and show an error. Complex or high-polygon assets, wireframe mode, and large output sizes increase SceneKit/GPU cost.

Sources

Morph3D

Generates a deforming 3D object, with optional incoming video mapping and automatic spin.

Inputs

Label	Signal	Purpose
`Texture`	Video	Optional surface video; otherwise the built-in material is used.
`Object`, `Rotate X`, `Rotate Y`, `Rotate Z`, `Zoom`, `Position X`, `Position Y`, `Seed`, `Resolution`, `Morph Speed`, `Morph Amount`, `Roughness`, `Spin X`, `Spin Y`, `UV Scale`, `UV Offset X`, `UV Offset Y`	Float/CV	Drive the matching object, camera, deformation, or UV control.

Outputs

Label	Signal	Purpose
`Out`	Video	Rendered procedural 3D object.

Controls

Control	Initial value	Range / step or options	Purpose
`Object`	Organic Morph	Organic Morph, Low-Poly Blob, Irregular Object	Selects the base mesh family.
`Rotate X`, `Rotate Y`, `Rotate Z`	0	0–1 turn / 0.01	Static orientation.
`Zoom`	1	0.25–4 / 0.01	Camera scale.
`Position X`, `Position Y`	0	−2–2 / 0.01	Placement.
`Seed`	0	0–999 / 1	Chooses a repeatable variation.
`Resolution`	0.55	0–1 / 0.01	Mesh detail.
`Morph Speed`	0	0–4 / 0.01	Deformation rate.
`Morph Amount`	0.45	0–1 / 0.01	Deformation depth.
`Roughness`	0.35	0–1 / 0.01	Surface irregularity.
`Spin X`, `Spin Y`	0	−2–2 / 0.01	Automatic revolutions per second.
`UV Scale`	1	0.25–4 / 0.01	Video tiling.
`UV Offset X`, `UV Offset Y`	0	−1–1 / 0.01	Video offset.
`Wireframe`	Off	Off (0), On (1)	Line rendering; intentionally has no CV jack.

Starting patch

Connect Gradient to Texture, set Morph Speed to 0.4, and send Out through Glow to Output.

Notes

Changing Object, Seed, Resolution, Roughness, or Morph Amount regenerates geometry; moving morphs also rebuild it periodically. High Resolution combined with fast morphing is one of the more expensive settings.

Sources

Camera

Captures a built-in or connected camera as a live video. The dedicated view handles macOS permission, device selection, quality, framing, mirroring, and exposure.

Inputs

Label	Signal	Purpose
`Preset`, `Fit`, `Flip H`, `Flip V`, `Exposure`	Float/CV	Drive the matching capture or presentation control.

Outputs

Label	Signal	Purpose
`Out`	Video	Latest captured camera frame, or black until one is available.

Controls

Control	Initial value	Range / step or options	Purpose
Device	System preferred	Currently discovered cameras	Chooses by device identity; the list refreshes while the module is open.
`Preset`	Auto	Auto, 720p, 1080p, Max	Restarts capture at the chosen quality. Auto currently uses the system High preset; Max chooses the largest advertised format.
`Fit`	Fit	Fit, Fill, Stretch	Fits with bars, crops to fill, or stretches.
`Flip H`, `Flip V`	Off	Off, On	Mirrors either axis.
`Exposure`	0.5	0–1 / 0.02	At 0.5 requests continuous auto exposure; other values request a supported locked exposure and also apply post-capture brightness.

Starting patch

Connect Out to Output, choose your webcam, use Fit for an uncropped view, then add Transform downstream.

Notes

Opening the module requests camera access. If denied, use its Open Privacy Settings action and re-enable Patchframe under macOS Camera privacy. The selected device ID is saved, but disconnected devices fall back to an available camera. 1080p/Max and downstream full-resolution effects cost more GPU and capture bandwidth. Edge Light is a system capability hint on supported macOS versions, not a Patchframe light effect.

Sources

Syphon Input

Receives a video published by another Syphon application on the same Mac, without a network encode/decode step.

Inputs

Label	Signal	Purpose
`Server`, `Flip H`, `Flip V`	Float/CV	Select the current server-list index or mirror the incoming frame.

Outputs

Label	Signal	Purpose
`Out`	Video	Latest frame from the selected Syphon server, or black when unavailable.

Controls

Control	Initial value	Range / step or options	Purpose
Source / `Server`	First available	Dynamic server list, numeric range 0–64 / 1	Selects a currently publishing Syphon server.
`Flip H`	Off	Off, On	Horizontal mirror.
`Flip V`	On	Off, On	Vertical mirror; on by default for video-coordinate convention.

Starting patch

Start a Syphon sender, select it in the module, then connect Out through Color Adjust to Output.

Notes

The server list is local and refreshes about once per second. Syphon support requires the linked/embedded Syphon framework and a running publisher; the view reports when its bridge is unavailable. Selection is stored as an index, so a reordered server list can point at a different publisher—recheck it after relaunch.

Sources

NDI Input

Discovers and receives an NDI sender on the network as live video.

Inputs

Label	Signal	Purpose
—	—	This module deliberately creates no input/CV jacks.

Outputs

Label	Signal	Purpose
`Out`	Video	Latest received NDI video frame, or black while disconnected.

Controls

Control	Initial value	Range / step or options	Purpose
`Source`	First available	Discovered NDI sources; CV selection 0–64 / 1	Connects to a discovered sender; the preferred source name is saved.
`Flip H`, `Flip V`	Off	Off, On	Mirrors the decoded frame.

Starting patch

Put the sender and Mac on the same network, wait for discovery, choose the source, and connect Out to Output.

Notes

Discovery may take 5–10 seconds. NDI requires a compatible NDI runtime/library; Patchframe dynamically loads and compatibility-checks it, and the module explains missing or incompatible installations. Only supported BGRA/BGRX video is converted; there is no NDI audio output. Frames aspect-fill the target and may crop. Network bandwidth, resolution, and sender frame rate affect CPU/GPU load and latency.

Sources

Shape

Draws a colored geometric mask, or reveals an incoming video through that shape.

Inputs

Label	Signal	Purpose
`Texture`	Video	Optional fill image; white is used when disconnected.
`Shape`, `Size`, `Softness`, `Rotation`, `Border W`, `Points`, `Fill`, `Red`, `Green`, `Blue`	Float/CV	Drive the matching geometry or color control.

Outputs

Label	Signal	Purpose
`Out`	Video	Transparent video containing the shape.

Controls

Control	Initial value	Range / step or options	Purpose
`Shape`	Circle	Circle, Polygon, Blob, Flower, Star, Irregular	Chooses geometry; Blob/Irregular choose a new procedural variation when selected.
`Size`	0.4	0.01–1 / 0.01	Overall size.
`Softness`	0.01	0–0.3 / 0.005	Edge feathering.
`Rotation`	0°	−180°–180° / 1°	Orientation.
`Border W`	0.05	0.01–0.5 / 0.01	Outline width.
`Points`	5	3–12 / 1	Point/side count for applicable shapes.
`Fill`	Fill	Fill, Outline	Solid or outlined rendering.
`Red`, `Green`, `Blue`	1	0–1 / 0.01	Shape tint.

Starting patch

Connect Video File to Texture, choose Star with 7 points, then composite Out over Solid Color.

Notes

Points and Border W are shape/mode dependent. This is a single-pass GPU generator and normally inexpensive.

Sources

Lines

Generates repeatable line, grid, radial, and ring patterns for backgrounds, masks, or modulation visuals.

Inputs

Label	Signal	Purpose
`Mode`, `Frequency`, `Thickness`, `Softness`, `Offset`, `Rotation`, `Red`, `Green`, `Blue`	Float/CV	Drive the matching pattern control.

Outputs

Label	Signal	Purpose
`Out`	Video	Generated line pattern.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Horiz	Horiz, Vert, Diag, Grid, Radial, Concentric	Pattern family.
`Frequency`	10	1–100 / 1	Number/density of repetitions.
`Thickness`	0.3	0.01–1 / 0.01	Line width within each repetition.
`Softness`	0.02	0–0.3 / 0.005	Edge feathering.
`Offset`	0	0–1 / 0.01	Pattern phase.
`Rotation`	0°	−180°–180° / 1°	Pattern orientation.
`Red`, `Green`, `Blue`	1	0–1 / 0.01	Line color.

Starting patch

Choose Grid, connect an LFO to Offset, and use the output as a mask or Blend layer.

Notes

High frequency can alias at small output sizes; add Softness or reduce Frequency. Rendering is a low-cost full-screen shader.

Sources

Noise

Creates animated procedural noise ranging from smooth Perlin fields to grain and film-like video, colored between two RGBA endpoints.

Inputs

Label	Signal	Purpose
`Scale`, `Speed`, `Octaves`, `Contrast`, `R1`, `G1`, `B1`, `A1`, `R2`, `G2`, `B2`, `A2`	Float/CV	Drive the matching video or palette control. Type and Seed intentionally have no CV jacks.

Outputs

Label	Signal	Purpose
`Out`	Video	Procedural noise video.

Controls

Control	Initial value	Range / step or options	Purpose
`Type`	Value	Value, Perlin, Grain, Flow, Mono, Film	Noise algorithm.
`Scale`	5	0.5–50 / 0.5	Spatial frequency.
`Speed`	1	0–10 / 0.1	Animation speed.
`Octaves`	4	1–8 / 1	Fractal detail layers.
`Contrast`	1	0–4 / 0.05	Tonal separation.
`Seed`	0	0–100 / 1	Repeatable variation.
`R1`, `G1`, `B1`, `A1`	0, 0, 0, 1	0–1 / 0.01	Low-value RGBA color.
`R2`, `G2`, `B2`, `A2`	1, 1, 1, 1	0–1 / 0.01	High-value RGBA color.

Starting patch

Choose Perlin, lower Speed to 0.2, and connect Out through Wave or use it as a monochrome mask.

Notes

It animates whenever Speed is above zero. Higher Octaves adds shader work; use fewer octaves for large canvases or stacked generators.

Sources

Gradient

Produces a two-color linear, radial, angular, or diamond gradient with RGBA endpoints.

Inputs

Label	Signal	Purpose
`Mode`, `Angle`, `CenterX`, `CenterY`, `R1`, `G1`, `B1`, `A1`, `R2`, `G2`, `B2`, `A2`	Float/CV	Drive the matching layout or color control.

Outputs

Label	Signal	Purpose
`Out`	Video	Generated gradient.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Linear	Linear, Radial, Angular, Diamond	Gradient geometry.
`Angle`	0°	−180°–180° / 1°	Direction/orientation.
`CenterX`, `CenterY`	0.5	0–1 / 0.01	Center for non-linear modes.
`R1`, `G1`, `B1`, `A1`	0, 0, 0, 1	0–1 / 0.01	First RGBA endpoint.
`R2`, `G2`, `B2`, `A2`	1, 1, 1, 1	0–1 / 0.01	Second RGBA endpoint.

Starting patch

Choose Radial, move Center X/Y, and use Out as the Palette input of Radiant Pack.

Notes

Angle has its clearest effect in Linear and Angular modes. This is a low-cost single-pass generator.

Sources

Checker

Generates a two-color checker pattern with independent X/Y density, transform, and soft edges.

Inputs

Label	Signal	Purpose
`Size X`, `Size Y`, `Rotation`, `Scale`, `OffsetX`, `OffsetY`, `Soft`, `R1`, `G1`, `B1`, `A1`, `R2`, `G2`, `B2`, `A2`	Float/CV	Drive the matching pattern or color control.

Outputs

Label	Signal	Purpose
`Out`	Video	Checker video.

Controls

Control	Initial value	Range / step or options	Purpose
`Size X`, `Size Y`	8	1–64 / 1	Horizontal and vertical cell counts.
`Rotation`	0°	−180°–180° / 1°	Pattern rotation.
`Scale`	1	0.1–4 / 0.01	Overall zoom.
`OffsetX`, `OffsetY`	0	0–1 / 0.01	Pattern phase.
`Soft`	0	0–0.5 / 0.01	Edge feathering.
`R1`, `G1`, `B1`, `A1`	0, 0, 0, 1	0–1 / 0.01	First tile RGBA.
`R2`, `G2`, `B2`, `A2`	1, 1, 1, 1	0–1 / 0.01	Second tile RGBA.

Starting patch

Set unequal Size X/Y, rotate 20°, then connect an LFO to Offset X for scrolling tiles.

Notes

Very small, hard-edged tiles can alias; raise Soft or lower the cell counts. Rendering is inexpensive.

Sources

TV Static

Creates animated television snow with scanline and interference layers, mapped between two colors.

Inputs

Label	Signal	Purpose
`Intensity`, `Scanlines`, `Interference`, `R1`, `G1`, `B1`, `A1`, `R2`, `G2`, `B2`, `A2`	Float/CV	Drive the matching static or palette control.

Outputs

Label	Signal	Purpose
`Out`	Video	Animated static video.

Controls

Control	Initial value	Range / step or options	Purpose
`Intensity`	1	0–1 / 0.01	Snow strength.
`Scanlines`	0.5	0–1 / 0.01	Horizontal line contribution.
`Interference`	0	0–1 / 0.01	Broad interference bands.
`R1`, `G1`, `B1`, `A1`	0, 0, 0, 1	0–1 / 0.01	Dark/static-low RGBA.
`R2`, `G2`, `B2`, `A2`	1, 1, 1, 1	0–1 / 0.01	Bright/static-high RGBA.

Starting patch

Lower Intensity, raise Interference, and Screen-blend the result over Video File.

Notes

The shader advances with patch time, so the image continually changes even when controls are still.

Sources

Text

Rasterizes editable text into a transparent video with font, size, position, and RGBA color controls.

Inputs

Label	Signal	Purpose
`Font`, `Size`, `PosX`, `PosY`, `R`, `G`, `B`, `A`	Float/CV	Drive the matching typography or color control.

Outputs

Label	Signal	Purpose
`Out`	Video	Rasterized text over transparency.

Controls

Control	Initial value	Range / step or options	Purpose
Text	`HELLO`	Free text	Content to draw.
`Font`	fyi Bold	fyi Bold, Pakatel In Regular, 007 Grotesk Regular	Selects a bundled face; the system font is a fallback if unavailable.
`Size`	72	8–400 / 1	Font size.
`PosX`, `PosY`	0.5	0–1 / 0.01	Normalized placement.
`R`, `G`, `B`, `A`	1	0–1 / 0.01	Text RGBA.

Starting patch

Enter a short title, set Alpha below 1, and Blend Out over a camera feed.

Notes

Unicode text is accepted, subject to font coverage. Unchanged text is cached; changing text, face, size, position, or color rerasterizes and uploads the full output, so rapid modulation—especially at large resolutions—can cost CPU/GPU time.

Sources

Plasma

Generates a flowing two-color plasma field in classic, marble, or nebula styles.

Inputs

Label	Signal	Purpose
`Scale`, `Speed`, `R1`, `G1`, `B1`, `R2`, `G2`, `B2`	Float/CV	Drive the matching motion or color control. Type intentionally has no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Animated plasma video.

Controls

Control	Initial value	Range / step or options	Purpose
`Type`	Classic	Classic, Marble, Nebula	Field algorithm.
`Scale`	4	1–16 / 0.5	Spatial frequency.
`Speed`	1	0–4 / 0.1	Animation speed.
`R1`, `G1`, `B1`	1, 0.2, 0.5	0–1 / 0.01	First color.
`R2`, `G2`, `B2`	0.8, 0, 1	0–1 / 0.01	Second color.

Starting patch

Choose Nebula, set Speed to 0.25, and run Out through Mirror/Kaleido.

Notes

Speed 0 freezes temporal motion. It is a continuously evaluated full-screen GPU shader.

Sources

Cellular

Builds an animated cellular field whose pattern can evolve automatically or jump to a new mutation on a trigger.

Inputs

Label	Signal	Purpose
`Trig`	Float/CV trigger	A rising crossing above 0.5 advances the mutation.
`Scale`, `Speed`, `Chaos`, `Edge Soft`, `R1`, `G1`, `B1`, `R2`, `G2`, `B2`	Float/CV	Drive the matching field or palette control.

Outputs

Label	Signal	Purpose
`Out`	Video	Cellular video.

Controls

Control	Initial value	Range / step or options	Purpose
`Scale`	8	2–24 / 0.5	Cell density.
`Speed`	0.5	0–8 / 0.01	Automatic motion rate.
`Chaos`	0	0–1 / 0.01	Irregularity/mutation strength.
`Edge Soft`	0.15	0–1 / 0.01	Cell-edge feathering.
`R1`, `G1`, `B1`	0.2, 0.8, 0.4	0–1 / 0.01	First color.
`R2`, `G2`, `B2`	0.1, 0.3, 0.6	0–1 / 0.01	Second color.

Starting patch

Connect a Step Sequencer pulse to Trig, set Chaos to 0.4, and send Out through Edge Detect.

Notes

With Trig connected, rising edges provide explicit mutation changes; without it, Speed/Chaos and patch time animate the field. The trigger is edge-based, not a continuous intensity input.

Sources

VideoSynth

Generates an oscillator-based video-synth field with waveform, warp, symmetry, and color animation.

Inputs

Label	Signal	Purpose
`Waveform`, `Freq X`, `Freq Y`, `Speed`, `Phase`, `Rotation`, `Polar`, `Warp`, `Mirror`, `Hue`, `Sat`, `Bright`, `Clr Spd`	Float/CV	Drive the matching synthesis control.

Outputs

Label	Signal	Purpose
`Out`	Video	Generated video-synth video.

Controls

Control	Initial value	Range / step or options	Purpose
`Waveform`	SIN	SIN, SAW, SQR, TRI	Base oscillator shape.
`Freq X`, `Freq Y`	4	0.5–32 / 0.5	Horizontal and vertical frequency.
`Speed`	1	0–4 / 0.1	Motion rate.
`Phase`	0	0–6.28 / 0.1	Oscillator phase.
`Rotation`	0	0–6.28 / 0.1	Field rotation in radians.
`Polar`, `Warp`	0	0–1 / 0.01	Polar remapping and spatial distortion.
`Mirror`	0	0–16 / 1	Symmetry segments.
`Hue`	0	0–1 / 0.01	Palette rotation.
`Sat`	0.7	0–1 / 0.01	Saturation.
`Bright`	0.5	0–1 / 0.01	Brightness.
`Clr Spd`	0.5	0–2 / 0.1	Independent color-cycle rate.

Starting patch

Choose TRI, set Mirror to 6, add some Warp, and connect an LFO to Hue.

Notes

Speed and Clr Spd can animate independently. This is a continuous full-screen GPU generator; layered high-resolution copies add proportional cost.

Sources

Wave Field

Draws an animated field of repeated colored waves with controllable count, spread, fade, and line character.

Inputs

Label	Signal	Purpose
`Count`, `Frequency`, `Amplitude`, `Speed`, `Spread`, `Fade`, `Thickness`, `Red`, `Green`, `Blue`	Float/CV	Drive the matching wave or color control.

Outputs

Label	Signal	Purpose
`Out`	Video	Animated wave field.

Controls

Control	Initial value	Range / step or options	Purpose
`Count`	12	1–64 / 1	Number of waves.
`Frequency`	3	0.1–20 / 0.1	Wave frequency.
`Amplitude`	0.15	0–1 / 0.01	Wave height.
`Speed`	1	0–5 / 0.1	Animation speed.
`Spread`	0.8	0–1 / 0.01	Distance across the field.
`Fade`	0.5	0–1 / 0.01	Depth/edge falloff.
`Thickness`	0.3	0.01–1 / 0.01	Line width.
`Red`, `Green`, `Blue`	0, 1, 0.6	0–1 / 0.01	Wave color.

Starting patch

Lower Speed, set Count to 20, and feed Out to Feedback for trailing wave motion.

Notes

The shader repeats work for Count; 64 waves at large output sizes is substantially heavier than the default.

Sources

Moiré

Interferes two animated line/ring fields and can combine the result with an incoming video for dense optical patterns.

Inputs

Label	Signal	Purpose
`In`	Video	Optional image used by the composite; a white fallback is used when disconnected.
`Mode`, `Density`, `Speed A`, `Speed B`, `Zoom`, `Center X`, `Center Y`, `Red`, `Green`, `Blue`, `Detune`, `Mode B`, `Contrast`, `Mix`, `Phase`, `Blend`, `Red 2`, `Green 2`, `Blue 2`, `Offset X`, `Offset Y`	Float/CV	Drive the matching field, color, or composition control. `BPM Sync` has no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Interference/composite video.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Lines	Lines, Concentric, Radial	First field.
`Density`	20	2–80 / 1	Pattern frequency.
`Speed A`, `Speed B`	0.3, −0.2	−2–2 / 0.05	Independent field motion.
`Zoom`	1	0.2–4 / 0.1	Pattern scale.
`Center X`, `Center Y`	0	−1–1 / 0.01	First field center.
`Red`, `Green`, `Blue`	0, 0.9, 1	0–1 / 0.01	First color.
`Detune`	0	−0.5–0.5 / 0.01	Separates the field frequencies.
`Mode B`	Follow	Follow, Lines, Concentric, Radial	Second field or follow first.
`Contrast`, `Mix`	1	0–1 / 0.01	Pattern contrast and composite amount.
`Phase`	0	−1–1 / 0.01	Relative phase.
`BPM Sync`	Off	Off, On	Uses patch beat as the clock instead of seconds.
`Blend`	Multiply	Normal, Add, Screen, Multiply, Overlay, Diff	Combination operation.
`Red 2`, `Green 2`, `Blue 2`	0, 0.9, 1	0–1 / 0.01	Second color.
`Offset X`, `Offset Y`	0	−1–1 / 0.01	Second field offset.

Starting patch

Connect Camera to In, set Mode B to Concentric, add slight Detune, and lower Mix.

Notes

BPM Sync follows Patchframe's beat clock; otherwise the two signed speeds use elapsed time. High Density produces fine detail that may alias, so reduce it or soften downstream.

Sources

Pulse Grid

Emits expanding pulses across a dot grid, running freely, on the patch beat, or from an external trigger.

Inputs

Label	Signal	Purpose
`Trig`	Float/CV trigger	Rising crossing above 0.95 starts a pulse and takes trigger timing control.
`Grid`, `Speed`, `BPM Sync`, `Beats`, `Dot Size`, `Softness`, `Gain`, `R1`, `G1`, `B1`, `R2`, `G2`, `B2`	Float/CV	Drive matching controls. Wave and Shape intentionally have no CV jacks.

Outputs

Label	Signal	Purpose
`Out`	Video	Animated pulse-grid video.

Controls

Control	Initial value	Range / step or options	Purpose
`Grid`	16	4–64 / 1	Dot-grid density.
`Speed`	1	0.1–5 / 0.1	Free-running timing/motion rate.
`BPM Sync`	Off	Off, On	Locks automatic pulses to patch beat.
`Beats`	1 beat	1/32, 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, 16, 32	Beat interval.
`Wave`	Radial	Radial, Box, Vertical, Horizontal, Scatter	Pulse travel pattern.
`Dot Size`	0.6	0.05–1 / 0.01	Dot size.
`Shape`	Circle	Circle, Square, Diamond	Dot geometry.
`Softness`	0.1	0–0.5 / 0.01	Dot-edge feathering.
`Gain`	1.5	0.5–5 / 0.1	Pulse brightness.
`R1`, `G1`, `B1`	1, 0.3, 0	0–1 / 0.01	Pulse color.
`R2`, `G2`, `B2`	0, 0.1, 0.3	0–1 / 0.01	Background color.

Starting patch

Connect a quarter-note pulse to Trig, choose Scatter, and send Out through Glow.

Notes

A connected trigger overrides automatic firing; disconnect it to use free/BPM timing. Trigger level must fall below the threshold before another rising edge can fire.

Sources

Sykora

Produces an infinite grid of solid and diagonally split tiles that rotates, reshuffles, or does both on each event.

Reference

Sykora refers to the work of Czech constructivist Zdeněk Sýkora (1920–2011), especially his 1969 geometric cladding on the tunnel ventilation towers in Prague.

Zdeněk Sýkora, tunnel ventilation towers, Prague, 1969

Inputs

Label	Signal	Purpose
`Trig`	Float/CV trigger	Rising crossing above 0.5 advances the selected Action.
`Density`, `Zoom`, `Pan X`, `Pan Y`, `BPM Sync`, `Beats`, `Amount`, `Action`, `Seed`, `R1`, `G1`, `B1`, `R2`, `G2`, `B2`	Float/CV	Drive the matching grid, timing, event, or color control.

Outputs

Label	Signal	Purpose
`Out`	Video	Animated Sykora pattern.

Controls

Control	Initial value	Range / step or options	Purpose
`Density`	4	1–48 / 1	Grid cells per unit.
`Zoom`	1	0.25–4 / 0.01	Pattern zoom.
`Pan X`, `Pan Y`	0	−1–1 / 0.01	Pattern translation.
`BPM Sync`	On	Off, On	Uses patch beat for automatic events.
`Beats`	1/4	×32, ×16, ×8, ×1, 1/2, 1/4, 1/8, 1/16, 1/32, 1/64, 1/128	Event interval shown by the dedicated view.
`Amount`	0.5	0–1 / 0.01	Fraction of tiles changed by an event.
`Action`	Both	Rotate, Reshuffle, Both	What an event changes.
`Seed`	0	0–1,000 / 1	Repeatable grid variation.
`R1`, `G1`, `B1`	0	0–1 / 0.01	First tile color.
`R2`, `G2`, `B2`	1	0–1 / 0.01	Second tile color.

Starting patch

Keep BPM Sync and Action on Both, set Amount near 0.2, and connect Out to Feedback for rhythmic pattern trails.

Notes

With Trig connected, rising edges override automatic events. Without it, BPM Sync uses the selected beat interval; free mode advances every 0.5 seconds. The multiplier/fraction labels above are the current UI labels and are intentionally reported verbatim.

Sources

Geometr

Spawns and fades layers of circles, squares, lines, and triangles in response to free, beat, or trigger timing.

Inputs

Label	Signal	Purpose
`Trig`	Float/CV trigger	Rising crossing above 0.95 spawns an event.
`Speed`, `BPM Sync`, `Beats`, `Density`, `Size Min`, `Size Max`, `Hue`, `Fade`, `Tilt`, `BG`	Float/CV	Drive timing and appearance. Shape toggles intentionally have no CV jacks.

Outputs

Label	Signal	Purpose
`Out`	Video	Layered geometric composition.

Controls

Control	Initial value	Range / step or options	Purpose
`Speed`	1	0.2–4 / 0.1	Free-running event rate.
`BPM Sync`	Off	Off, On	Locks events to patch beat.
`Beats`	1 beat	1/32, 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, 16, 32	Beat interval.
`Density`	4	1–8 / 1	Shapes created per event.
`Size Min`	0.03	0.01–0.5 / 0.01	Minimum random shape size.
`Size Max`	0.15	0.05–1 / 0.01	Maximum random shape size.
`Hue`	0	0–1 / 0.01	Palette offset.
`Fade`	3	0–10 / 0.1	Shape lifetime in seconds; 0 disables fading.
`Tilt`	0.125	0–1 / 0.01	Canvas tilt; 0.125 corresponds to 45°.
`BG`	0	0–0.5 / 0.01	Background alpha/level.
`Circle`, `Square`, `Line`, `Triangle`	On	Off, On	Enables each shape family.

Starting patch

Use BPM Sync at 1/2 beat, disable two shape families, and raise Fade for overlapping layers.

Notes

A connected trigger overrides free/BPM spawning. Turning every shape family off prevents new visible shapes. At most 512 shapes remain live; high Density plus long Fade reaches that cap and costs more GPU work.

Sources

LiveCode

Compiles a user-written Metal mainImage function into a live video generator with eight general CV values.

LiveCode shader manual

Inputs

Label	Signal	Purpose
`CV0` … `CV7`	Float/CV	Supplies `u.cv[0]` … `u.cv[7]` inside `mainImage`.

Outputs

Label	Signal	Purpose
`Out`	Video	Result of the last successfully compiled shader, or black before the first successful compile.

Controls

Control	Initial value	Range / step or options	Purpose
Edit	Closed	Open editor	Opens the floating shader editor.
Code	Built-in sine example	Metal source defining `float3 mainImage(float2 uv, constant Uniforms &u)`	Edits the generator using `u.time`, `u.resolution`, and eight CV values.
Compile	—	Action	Compiles asynchronously and displays success or the compiler error.
Auto	Off	Off, On	Debounces edits and compiles automatically.
Snippet library	No active snippet	Bundled and user snippets; load, save, adjust, delete	Reuses shader examples and personal snippets.
Assist	Closed	Prompt-driven Claude draft/adjustment	Optional external shader-writing assistant; requires its configured API credential and network service.

Starting patch

Connect an LFO to CV0, open Edit, compile the default shader, then change its color expression while the output is visible.

Notes

See the LiveCode shader manual for shader structure, Uniforms, UV coordinates, recipes, and common errors. LiveCode always has exactly eight fixed CV ports; editing code does not rebuild the port list. Only CV references inside mainImage are supported by the documented wrapper. A failed compile keeps the previous successful output, marks the editor red, and reports the error; if no compile has succeeded, output is black. Shader cost and safety depend on the code—large loops or expensive per-pixel math can stall the GPU.

Sources

ISF

Loads an Interactive Shader Format file and builds its ports and controls from the shader's JSON metadata at runtime.

Inputs

ISF metadata type	Runtime signal	Ports created
`float`, `bool`, `long`, `event`	Float/CV	One port using the metadata input name. Events are passed as numeric uniforms; Patchframe does not add an automatic one-frame reset.
`point2D`	Float/CV	`<name>.X`, `<name>.Y`.
`color`	Float/CV	`<name>.R`, `<name>.G`, `<name>.B`, `<name>.A`.
`image`, `audio`, `audioFFT`	Video	One video port using the metadata input name; these are ISF video inputs, not Patchframe Audio signals.

Outputs

Label	Signal	Purpose
`Out`	Video	Rendered ISF result.

Controls

Control	Initial value	Range / step or options	Purpose
Shader file	None	`.fs`, `.isf`, `.frag`, `.glsl`	Loads an ISF shader, replacing the current selection.
Generated `float`	Metadata default, otherwise minimum	Metadata MIN–MAX, defaults 0–1 / 0.01	Numeric shader uniform.
Generated `bool`	Metadata default, otherwise Off	Off, On	Boolean shader uniform.
Generated `long`	Metadata default, otherwise 0	0 to `VALUES.count−1`, or 0–3 / 1	Integer uniform; current UI exposes the numeric value rather than metadata labels.
Generated `event`	0	0–1 / 1	Event-valued uniform controlled by its input/control.
Generated `point2D`	Metadata default, otherwise 0.5/0.5	Metadata ranges, otherwise 0–1 / 0.01	Two coordinate controls.
Generated `color`	Metadata default, otherwise 1/1/1/1	0–1 / 0.01	Four RGBA controls.
`Flip H`, `Flip V`	Off	Off, On	Mirrors final output; these fixed controls have no CV jacks.

Starting patch

Load an ISF generator, inspect the newly created controls, connect an LFO to one generated Float/CV jack, and route Out to Output.

Notes

Port names, counts, defaults, and ranges are shader-defined and can only be known after parsing. The file is path/bookmark-referenced. Compilation runs off the main thread; parse/compile errors remain visible and do not invent substitute controls. Multi-pass shaders are supported. Imported image resources are resolved relative to the shader file and must remain accessible. High pass counts, loops, or video inputs can be GPU-heavy.

Sources

Wireframe

Renders a rotating analytic sphere, cube, cylinder, or torus as a wire-style video, optionally using an incoming video on the surface.

Inputs

Label	Signal	Purpose
`Texture`	Video	Optional surface image.
`Size`, `Rotate X`, `Rotate Y`, `Rotate Z`, `Line density`, `Line width`, `Camera dist`, `Camera orbit`, `Torus major`, `Torus minor`, `Cylinder H`, `Box edge`	Float/CV	Drive matching geometry or camera controls. Shape intentionally has no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Rendered wire object.

Controls

Control	Initial value	Range / step or options	Purpose
`Shape`	Sphere	Sphere, Cube, Cylinder, Donut	Object family.
`Size`	0.4	0.1–1 / 0.01	Object scale.
`Rotate X`, `Rotate Y`, `Rotate Z`	0	0–1 turn / 0.01	Object orientation.
`Line density`	12	4–48 / 1	Wire/grid density.
`Line width`	0.012	0.002–0.05 / 0.002	Stroke thickness.
`Camera dist`	2.5	1.2–8 / 0.1	Viewing distance.
`Camera orbit`	0	0–1 turn / 0.01	Camera rotation around the object.
`Torus major`, `Torus minor`	0.35, 0.15	0.1–0.6 / 0.01; 0.03–0.35 / 0.01	Donut radii.
`Cylinder H`	0.5	0.2–1 / 0.01	Cylinder height.
`Box edge`	0.04	0.01–0.15 / 0.005	Cube edge treatment.

Starting patch

Choose Donut, connect Gradient to Texture, modulate Camera orbit, and connect Out to Output.

Notes

Torus, cylinder, and box controls only affect their matching shapes. Dense, thin lines can alias. This analytic full-screen renderer evaluates object intersections per pixel, so high resolutions are more expensive.

Sources

Radiant Pack

Collects 21 performance-oriented procedural looks behind a shared palette, tempo, motion, and intensity interface.

Inputs

Label	Signal	Purpose
`Palette`	Video	Optional color source mixed into supported looks.
`BPM Sync`, `Beats`, `Speed`, `Intensity`, `Scale`, `Hue`, `Decay`, `Density`, `Sharp`, `Octaves`, `Palette Mix`	Float/CV	Drive matching shared controls. Preset intentionally has no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Selected Radiant look.

Controls

Control	Initial value	Range / step or options	Purpose
Type / `Preset`	Dynamic / Horizon	Dynamic: Horizon, Eclipse, Voltage, Vertigo, Thunder, Laser, Kinetic, Feedback; Geometric: Tesseract, Caustics, Kaleido, Clockwork, Chladni, Sacred, Precision; Organic: Gilt, Stardust, Fluid, Ink, Murmur, Chaos	Two menus select one of the 21 presets.
`BPM Sync`	On	Off, On	Uses patch tempo.
`Beats`	1 beat	1/32, 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, 16, 32	Beat interval.
`Speed`	1	0.05–4 / 0.05	Motion rate.
`Intensity`	1	0.2–3 / 0.05	Look strength/brightness.
`Scale`	1	0.2–4 / 0.05	Spatial scale.
`Hue`	0	0–1 / 0.01	Palette rotation.
`Decay`	0.85	0–1 / 0.01	Persistence for applicable looks.
`Density`, `Sharp`	0.5	0–1 / 0.01	Element density and edge sharpness.
`Octaves`	4	1–8 / 1	Detail layers for applicable organic looks.
`Palette Mix`	1	0–1 / 0.01	Incoming Palette influence.

Starting patch

Connect Gradient to Palette, select Organic → Fluid, leave BPM Sync on, and lower Palette Mix to blend the two color systems.

Notes

Presets use different rendering engines, so shared controls can have look-specific meaning and some are intentionally inactive in some presets. Preset changes clear persistent state. Feedback/flow looks, high Octaves/Density, and long Decay can be GPU-heavy; geometric presets keep at most 512 live shapes.

Sources

Particles

Simulates up to 500,000 GPU particles with gravity, turbulence, trails, and optional audio-reactive motion/brightness.

Inputs

Label	Signal	Purpose
`Audio`	Audio	Optional analysis source. When absent, Audio React uses the engine's global audio RMS.
`Count`, `Lifetime`, `Speed`, `Gravity X`, `Gravity Y`, `Turbulence`, `Spawn X`, `Spawn Y`, `Spread`, `R`, `G`, `B`, `Brightness`, `Audio React`	Float/CV	Drive matching simulation, color, or reactivity controls.

Outputs

Label	Signal	Purpose
`Out`	Video	Particle rendering with accumulated trails.

Controls

Control	Initial value	Range / step or options	Purpose
`Count`	100,000	1,000–500,000 / 1,000	Active particle count.
`Lifetime`	4	0.5–20 / 0.1	Particle lifespan.
`Speed`	1	0–5 / 0.05	Initial/motion speed.
`Gravity X`, `Gravity Y`	0, 1	−5–5 / 0.1	Acceleration.
`Turbulence`	1	0–5 / 0.1	Procedural force strength.
`Spawn X`, `Spawn Y`	0.5, 0.3	0–1 / 0.01	Normalized emitter position.
`Spread`	0.08	0–1 / 0.01	Emitter width.
`R`, `G`, `B`	0.4, 0.2, 1	0–1 / 0.01	Particle color.
`Brightness`	1	0–5 / 0.05	Render intensity.
`Audio React`	0.5	0–1 / 0.01	RMS influence on the simulation.

Starting patch

Connect Audio Follow's Audio output to Audio, begin around 50,000 particles, and raise Audio React while music plays.

Notes

This is among the heaviest source modules: it uses GPU simulation, rendering, and full-resolution accumulation/trail buffers. Raising Count can reallocate/reinitialize particle storage. Lower Count and patch resolution first when frames drop. The connected Audio jack takes priority; the global audio level is the fallback.

Sources

Voronoi

Generates an animated Voronoi/cellular field in colorful, edge, or filled-cell form.

Inputs

Label	Signal	Purpose
`Scale`, `Speed`, `Mode`, `R`, `G`, `B`	Float/CV	Drive matching field and color controls.

Outputs

Label	Signal	Purpose
`Out`	Video	Animated Voronoi video.

Controls

Control	Initial value	Range / step or options	Purpose
`Scale`	8	1–32 / 0.5	Cell density.
`Speed`	0.5	0–2 / 0.01	Animation speed.
`Mode`	Colorful	Colorful (0), Edges (1), Cells (2)	Rendering style.
`R`, `G`, `B`	1, 0.5, 0.2	0–1 / 0.01	Base tint.

Starting patch

Choose Edges, set Speed near 0.15, and use Out to displace an Image File.

Notes

Speed 0 freezes motion. Mode currently appears through the generic numeric control rather than a dedicated named menu, but the shader's three meanings are shown above.

Sources

Starfield

Creates a layered star-flight field in Stars, Hyperspace, or Warp styles, with trails, scan quality, color, and tempo-aware speed.

Inputs

Label	Signal	Purpose
`Speed`, `Density`, `Scan`, `Depth`, `Trail`, `Trail Wid`, `Layer Var`, `Size`, `Brightness`, `R`, `G`, `B`, `Center X`, `Center Y`, `Twist`, `Hue`, `Zoom`, `BG Alpha`	Float/CV	Drive matching field controls. Scan keeps a CV jack for saved-patch compatibility. Look and Patch BPM have no CV jacks.

Outputs

Label	Signal	Purpose
`Out`	Video	Animated starfield.

Controls

Control	Initial value	Range / step or options	Purpose
`Look`	Hyperspace	Stars, Hyperspace, Warp	Flight style.
`Speed`	0.25	0–1 / 0.01	Flight rate.
`Density`	0.5	0–1 / 0.01	Star population.
`Scan`	3×3	1×1, 3×3, 5×5	Per-pixel neighborhood quality/work.
`Depth`	0.5	0–1 / 0.01	Depth range.
`Trail`	0.38	0–1 / 0.01	Trail amount.
`Trail Wid`	0.16	0–1 / 0.01	Trail width.
`Layer Var`	0.55	0–1 / 0.01	Difference among depth layers.
`Size`	0.55	0–1 / 0.01	Star size.
`Brightness`	0.85	0–1 / 0.01	Star intensity.
`R`, `G`, `B`	1	0–1 / 0.01	Base color.
`Center X`, `Center Y`	0	−1–1 / 0.01	Vanishing point.
`Twist`, `Hue`, `Zoom`	0, 0, 0.5	0–1 / 0.01	Spiral, color rotation, and field zoom.
`BG Alpha`	0	0–1 / 0.01	Background opacity.
`Patch BPM`	Off	Off, On	Maps beat position to a tempo-scaled timebase; at 120 BPM the Speed feel matches free time.

Starting patch

Choose Warp, use 3×3 Scan, offset the center slightly, and connect Out through Glow.

Notes

Scan is the main performance lever: 5×5 samples 25 neighboring cells per pixel and can be expensive at high resolution; 1×1 is the fast preview choice. Patch BPM changes the timebase, not the module's ports.

Sources

Clrmchnx

Generates a seeded, print-inspired layered composition with paper, stripe, halftone, edge, and neon treatments.

Inputs

Label	Signal	Purpose
`Trig`	Float/CV trigger	Rising crossing above 0.5 chooses a new seeded variation.
`Concept`, `Paper`, `Mode`, `Seed`, `Offset`, `Layers`, `Hue`, `Contrast`, `Edge`, `Stripe`, `Halftone`, `Neon`	Float/CV	Drive the matching generator control.

Outputs

Label	Signal	Purpose
`Out`	Video	Generated Clrmchnx composition.

Controls

Control	Initial value	Range / step or options	Purpose
`Concept`	0	0–2 / 1	Selects one of three concepts. Current source/UI does not publish names.
`Paper`	On	Off (0), On (1)	Adds the paper treatment.
`Mode`	0	0–5 / 1	Selects one of six render modes. Current source/UI does not publish names.
`Seed`	42	0–10,000 / 1	Repeatable composition variation.
`Offset`	0.45	0–1 / 0.01	Layer offset.
`Layers`	18	8–28 / 1	Layer count.
`Hue`	0	0–1 / 0.01	Palette rotation.
`Contrast`	0.5	0–1 / 0.01	Tonal contrast.
`Edge`	0.35	0–1 / 0.01	Edge treatment.
`Stripe`	0.42	0–1 / 0.01	Stripe contribution.
`Halftone`	0.38	0–1 / 0.01	Halftone contribution.
`Neon`	0.85	0–1 / 0.01	Neon-color contribution.

Starting patch

Connect a slow trigger to Trig, keep Paper on, and adjust Hue and Halftone for changing poster-like frames.

Notes

The image is stable between control changes/triggers rather than being a continuously time-driven animation. Concept and Mode are honestly numeric/WIP in the current generic UI; names are not invented here.

Sources

Spirograph

Draws animated inner- or outer-wheel spirograph curves with repeated hues, adjustable geometry, and partial-to-full trails.

Inputs

Label	Signal	Purpose
`Type`, `Radius`, `r`, `d`, `Repeats`, `Phase`, `Speed`, `Thickness`, `Scale`, `Hue`, `Hue Spread`, `BG Alpha`, `Trail`	Float/CV	Drive matching curve, motion, color, or trail controls.

Outputs

Label	Signal	Purpose
`Out`	Video	Rendered spirograph video.

Controls

Control	Initial value	Range / step or options	Purpose
`Type`	Inner	Inner, Outer	Hypotrochoid or epitrochoid-style construction.
`Radius`	0.6	0.1–1 / 0.01	Fixed-circle radius.
`r`	0.25	0.02–0.5 / 0.01	Rolling-circle radius.
`d`	0.2	0–0.8 / 0.01	Pen distance from rolling-circle center.
`Repeats`	5	1–20 / 1	Repeated colored curves.
`Phase`	0	0–6.28 / 0.1	Starting phase in radians.
`Speed`	0.5	0–3 / 0.1	Animation rate.
`Thickness`	0.025	0.005–0.12 / 0.005	Stroke width.
`Scale`	1	0.2–2 / 0.05	Overall size.
`Hue`	0	0–1 / 0.01	Base hue.
`Hue Spread`	1	0–1 / 0.01	Color variation across repeats.
`BG Alpha`	0	0–1 / 0.01	Background opacity.
`Trail`	1	0–1 / 0.01	Fraction of the curve drawn; 1 shows the full path.

Starting patch

Set Trail below 0.3, raise Repeats, and use a slow Speed for a drawing-on animation.

Notes

Some radius ratios close neatly while others make long evolving curves. More repeats and thicker/full trails increase per-pixel curve work.

Sources

Audio Visualizer

Analyzes a connected audio stream and renders it in one of twelve spectrum, waveform, radial, or meter visual styles while passing the audio onward.

Inputs

Label	Signal	Purpose
`Audio In`	Audio	Audio frames to analyze and pass through. There is no global-audio fallback when disconnected.
`Low Gain`, `Mid Gain`, `High Gain`, `Smoothing`, `Red`, `Green`, `Blue`	Float/CV	Drive band response, temporal smoothing, and tint. Mode intentionally has no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Audio-reactive visualization.
`Audio Out`	Audio	The connected audio frame passed through unchanged; when no audio arrives, an empty 48 kHz frame is emitted.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Sun	Bars, Aurora, Silk, Scope, Sun, Mandala, Nebula, Tunnel, Julia, Burst, Bands, VU	Visualization style.
`Low Gain`, `Mid Gain`, `High Gain`	1	0–4 / 0.05	Per-band analysis gain.
`Smoothing`	0.5	0–0.95 / 0.01	Temporal averaging; higher values move more slowly.
`Red`, `Green`, `Blue`	0.2, 0.9, 1	0–1 / 0.01	Base visualization tint.

Starting patch

Connect Audio Follow's Audio output to Audio In, connect visual Out to Output, and optionally route Audio Out to Output's audio input. Try Bars first to confirm band response.

Notes

The module performs FFT/spectrum, waveform, stereo-history, and band analysis from the connected Audio signal only; device/system-audio permission and selection belong to the upstream audio-capture module or app audio settings. It continuously renders a full video plus a low-resolution preview. Audio Out is a pass-through, not effected audio.

Effects

Transform

Reframes a video with independent scale, three-axis rotation, and position controls.

Inputs

Label	Signal	Purpose
`In`	Video	Image to transform.
`Scale`, `Scale X`, `Scale Y`, `Rotation X`, `Rotation Y`, `Rotation Z`, `Pos X`, `Pos Y`	Float/CV	Drive the matching transform control.

Outputs

Label	Signal	Purpose
`Out`	Video	Transformed image.

Controls

Control	Initial value	Range / step or options	Purpose
`Scale`, `Scale X`, `Scale Y`	1	0.01–4 / 0.01	Uniform or independent horizontal/vertical scale.
`Lock Scale`	On	Off, On	Uses `Scale` when on and `Scale X/Y` when off; no CV jack.
`Rotation X`, `Rotation Y`, `Rotation Z`	0°	0–360° / 1°	Tilts or rotates the image around each axis.
`Pos X`, `Pos Y`	0	−1–1 / 0.01	Moves the transformed image.

Starting patch

Connect a source to In, then try Scale 1.2 and Rotation Z 15°.

Notes

The source is fitted without stretching before the transform; areas moved outside the frame are transparent.

Effects

Blend

Provides an always-active compositor and a separate A-to-B transition circuit in one module.

Inputs

Label	Signal	Purpose
`A`, `B`, `M` (Comp page)	Video	Foreground, background, and optional mask for the compositor.
`A`, `B` (Trans page)	Video	Start and end images for the transition.
`Mode`, `Opacity`, `Mode Mix`, `Feedback`, `Displace`, `Mask Key`, `Mask Soft`	Float/CV	Drive the matching compositor control.
`Transition`, `Progress`, `Wipe Angle`, `Sync`, `Sync Beats`, `Sync Dir`	Float/CV	Drive the matching transition control.

Outputs

Label	Signal	Purpose
`Comp`	Video	Composited A/B result.
`Trans`	Video	Transition result.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Normal	Normal, Add, Screen, Multiply, Overlay, Difference, Dodge, Burn, Soft Light, Hard Light, Exclude, Hue, Sat, Color, Lumin	Comp blend operation.
`Opacity`	1	0–1 / 0.01	Comp strength.
`Mode Mix`	0	0–1 / 0.01	Crossfades toward the next blend mode, wrapping after Lumin.
`Feedback`	0	0–1 / 0.01	Mixes in Comp's previous frame.
`Displace`	0	0–1 / 0.01	Uses B luminance gradients to displace A.
`Mask Key`	Off	Off — Multiply mask; On — Luma key	Changes how M is interpreted.
`Mask Soft`	0.1	0–1 / 0.01	Feathering for luma-key masks.
`Transition`	Dissolve	Dissolve, Wipe H, Wipe V, Perlin, Glitch, Voronoi, Kaleido, Pix Sort, Wipe ∠	Trans style.
`Progress`	0	0–1 / 0.01	Manual A-to-B position.
`Wipe Angle`	0°	0–360° / 1°	Direction for Wipe ∠.
`Sync`	Off	Off, On	Drives Progress from patch BPM/Link.
`Sync Beats`	1	1/32, 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, 16, 32	Synced transition length.
`Sync Dir`	Forward	Forward, Backward, Ping-pong	Synced movement direction.

Starting patch

Feed two sources into the Comp A and B jacks, select Screen, and lower Opacity; use the Trans page independently for a BPM-synced wipe.

Notes

Either circuit passes through its one connected video when the other is absent. Comp feedback keeps one full-frame history video and resets when the output format changes; changing the visible page does not disable the hidden circuit. Mask Key and Sync can be changed on the module but cannot currently be CV-patched there.

Effects

Pixellate

Reduces an image to adjustable blocks of sampled color.

Inputs

Label	Signal	Purpose
`In`	Video	Image to pixelate.
`Size`	Float/CV	Controls block size.

Outputs

Label	Signal	Purpose
`Out`	Video	Pixelated image.

Controls

Control	Initial value	Range / step or options	Purpose
`Size`	0.02	0.002–0.2 / 0.001	Block size in normalized image space.

Starting patch

Connect video to In and raise Size toward 0.06 for an obvious mosaic.

Notes

Each frame is processed once, making this a comparatively light effect.

Effects

Pixel Sort

Creates directional pixel-stretch and pixel-sorted bands with a controlled held-frame trail.

Inputs

Label	Signal	Purpose
`In`	Video	Image to process.
`Amount`, `Direction`, `Mode`, `Threshold`, `Span`, `Width`, `Hold`, `Blend`, `Stability`	Float/CV	Drive the matching control.

Outputs

Label	Signal	Purpose
`Out`	Video	Sorted/stretching result.

Controls

Control	Initial value	Range / step or options	Purpose
`Amount`	0.9	0–1 / 0.01	Overall displacement.
`Direction`	Horizontal	Horizontal, Vertical	Sort axis.
`Mode`	Luma	Luma, Hue, Saturation, Edge	Chooses the feature used to drive the sort treatment.
`Threshold`	0.38	0–1 / 0.01	Luminance gate.
`Span`	0.62	0–1 / 0.01	Search distance, from a few pixels to half the axis.
`Width`	0	0–1 / 0.01	Stroke width, mapped from 1 to 48 pixels.
`Hold`	0.24	0–0.92 / 0.01	Previous-frame contribution.
`Blend`	1	0–1 / 0.01	Wet/dry mix.
`Stability`	0.9	0–1 / 0.01	Reduces time-varying jitter.

Starting patch

Use moving video, keep Amount high, then sweep Threshold and Span until bright regions pull into bands.

Notes

The module keeps one full-resolution held frame and clears it when the output format changes. Hold carries the previous result forward; lowering Stability keeps motion in the effect, so either setting can keep it active on a still input. High Span values can be GPU-heavy. The Mode menu currently also shows Overlay and Diff; both produce Edge.

Effects

Mirror/Kaleido

Mirrors, folds, or tiles a video around an adjustable center.

Inputs

Label	Signal	Purpose
`In`	Video	Image to fold.
`Mode`, `Segments`, `Angle`, `Center X`, `Center Y`, `Input X`, `Input Y`, `Dome`, `Sides`, `Tile Size`	Float/CV	Drive the matching control.

Outputs

Label	Signal	Purpose
`Out`	Video	Mirrored or tiled image.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Mirror H	Mirror H, Mirror V, Mirror Both, Kaleidoscope, Polygon Tiles	Mapping style.
`Segments`	6	2–32 / 1	Kaleidoscope wedge count.
`Angle`	0°	−180–180° / 1°	Rotates the mapping.
`Center X`, `Center Y`	0.5	0–1 / 0.005	Fold center.
`Input X`, `Input Y`	0	−1–1 / 0.005	Offsets the sampled image.
`Dome`	0	−50–50 / 0.5	Curves the Polygon Tiles surface.
`Sides`	3	3–6 / 1	Polygon side count.
`Tile Size`	0.25	0.04–1 / 0.01	Polygon tile scale.

Starting patch

Select Kaleidoscope, set Segments to 8, then move Center X/Y around a detailed source.

Notes

The module changes which controls are prominent by mode, but all parameters remain part of module state and are CV-addressable.

Effects

Color Adjust

Applies basic tonal/color correction, optional inversion, and video-driven colorization.

Inputs

Label	Signal	Purpose
`In`	Video	Image to grade.
`Colorize`	Video	Optional color source used to recolor the image.
`Brightness`, `Contrast`, `Hue`, `Saturation`, `Invert`, `Invert Threshold`	Float/CV	Drive the matching control; Invert CV switches on at its threshold.

Outputs

Label	Signal	Purpose
`Out`	Video	Adjusted image.

Controls

Control	Initial value	Range / step or options	Purpose
`Brightness`	0	−1–1 / 0.01	Adds or removes brightness.
`Contrast`	1	0–4 / 0.01	Tonal contrast; 1 is neutral.
`Hue`	0°	−180–180° / 1°	Rotates hue.
`Saturation`	1	0–2 / 0.01	Color saturation; 1 is neutral.
`Invert`	Off	Off, On	Inverts colors immediately when on.
`Invert Threshold`	100%	0–100 / 1	Required normalized Invert CV level, expressed as percent.

Starting patch

Connect a source to In, lower Saturation, then feed a gradient into Colorize.

Notes

Manual Invert overrides the threshold. Without a Colorize video, colorization is disabled rather than using an arbitrary fallback color.

Effects

Blur

Offers a fast Metal Performance Shaders Gaussian blur and a configurable multi-pass shader blur.

Inputs

Label	Signal	Purpose
`In`	Video	Image to blur.
`Radius 1`, `Radius 2`, `Passes`	Float/CV	Drive the active engine's radius or pass count.

Outputs

Label	Signal	Purpose
`Out`	Video	Blurred image.

Controls

Control	Initial value	Range / step or options	Purpose
`Engine`	MPS	MPS, Multi-pass	Chooses blur implementation; no CV jack.
`Radius 1`	4	0–40 / 0.1	MPS blur radius.
`Radius 2`	4	0–20 / 0.1	Multi-pass blur radius.
`Passes`	4	1–12 / 1	Multi-pass iteration count.

Starting patch

Begin with MPS and Radius 1 around 8; use Multi-pass when you want its softer repeated-pass look.

Notes

Radius near zero passes the source through. Multi-pass repeats the blur twice per iteration and becomes substantially more expensive as Passes rises; legacy blur presets migrate into this unified module.

Effects

Glitch

Layers rhythmic RGB separation, dropout, scanline, interference, sort, and stretch artifacts.

Inputs

Label	Signal	Purpose
`In`	Video	Image to disrupt.
`Amount`, `RGB Shift`, `Dropout`, `Sync Jump`, `Scanlines`, `Interference`, `Pixel Sort`, `Edge Stretch`, `Chance`, `Rate`	Float/CV	Drive the matching artifact control.

Outputs

Label	Signal	Purpose
`Out`	Video	Glitched image.

Controls

Control	Initial value	Range / step or options	Purpose
`Amount`	0.5	0–1 / 0.01	Overall distortion.
`RGB Shift`	0.03	0–0.15 / 0.001	Channel separation distance.
`Dropout`, `Sync Jump`, `Scanlines`, `Interference`, `Pixel Sort`, `Edge Stretch`	0	0–1 / 0.01	Strength of each artifact family.
`Chance`	1	0–1 / 0.01	Probability that timed glitches occur.
`Rate`	12	1–32 / 1	Temporal event rate.

Starting patch

Raise RGB Shift and Sync Jump, then lower Chance for intermittent events.

Notes

Time-based artifacts keep animating while the module is active. Combining Pixel Sort and Edge Stretch can be more demanding than the basic channel and scanline effects.

Effects

Feedback

Accumulates previous output frames into a controllable video feedback loop.

Inputs

Label	Signal	Purpose
`In`	Video	Live image injected into the loop.
`Clear`	Float/CV trigger	A rising value reaching 1 clears history.
`Freeze`	Float/CV trigger	A rising value reaching 1 toggles the held state.
`Mix`, `Zoom`, `Rotation`, `Hue Shift`, `Mode`, `Decay`	Float/CV	Drive feedback controls. `Address` has no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Current accumulated frame.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Normal	Normal, Add, Screen, Multiply, Overlay, Difference	Blend operation.
`Address`	Clamp	Clamp, Wrap, Mirror	Behavior outside image bounds.
`Clear` button	—	Momentary	Clears the feedback buffer.
`Freeze` button	Off	Latched Off/On	Holds the current buffer and stops history writes.
`Mix`	0.85	0–0.99 / 0.01	Previous-frame amount.
`Zoom`	1.02	0.9–1.2 / 0.005	Per-frame feedback scaling.
`Rotation`	0°	−10–10° / 0.1°	Per-frame rotation.
`Hue Shift`	0°	−30–30° / 0.5°	Per-frame hue drift.
`Decay`	1	0.9–1 / 0.005	Per-frame brightness retention.

Starting patch

Feed video to In, keep Mix below 0.9, and use a tiny Zoom or Rotation; press Clear if the loop saturates.

Notes

The module keeps one full-resolution history frame, starts clear, and resets when the output format changes. Freeze ignores new input until toggled off. Mix is capped below 1, but bright blend modes and Decay 1 can still build up quickly. Motion and decay are tuned around 60 fps, so their feel can change with frame rate.

Effects

Chroma Key

Keys video A over video B using either luminance or a chosen chroma color.

Inputs

Label	Signal	Purpose
`A`, `B`	Video	Foreground to key and replacement/background image.
`Sensitivity`, `Spill`, `Smoothing`, `Key R`, `Key G`, `Key B`	Float/CV	Drive key tolerance, cleanup, and color. Mode has no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Keyed composite.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Chroma	Luma, Chroma	Keying method.
`Sensitivity`	0.5	0.01–1 / 0.01	Key tolerance.
`Spill`	0.5	0–1 / 0.01	Chroma spill suppression.
`Smoothing`	0.1	0–1 / 0.01	Edge feathering.
`Key R`, `Key G`, `Key B`	0, 1, 0	0–1 / 0.01	Chroma key color; shown only in Chroma mode.

Starting patch

Put green-screen video in A, the replacement in B, then tune Sensitivity and Smoothing around the default green key.

Notes

B alone passes through. A alone is keyed against transparency, and with neither input connected the output clears. This is the picker-visible keying module, distinct from the separate non-picker chromaKey compatibility entry.

Effects

Motion Trace

Leaves bright, decaying traces where moving image details have just been.

Inputs

Label	Signal	Purpose
`In`	Video	Live image used for motion comparison.
`Retention`, `Fade`, `Smear`, `Threshold`	Float/CV	Drive the matching trail control.

Outputs

Label	Signal	Purpose
`Out`	Video	Live image composited with the accumulated trace.

Controls

Control	Initial value	Range / step or options	Purpose
`Retention`	0.92	0.5–0.995 / 0.005	Strength of newly deposited ghosts.
`Fade`	0.98	0.9–1 / 0.005	Brightness retained by existing traces each frame.
`Smear`	0	0–1 / 0.05	Spreads accumulated traces into neighboring pixels.
`Threshold`	0.05	0–0.4 / 0.005	Minimum frame-to-frame color change treated as motion.

Starting patch

Connect a moving, high-contrast source to In, keep Retention near 0.9, and lower Fade if traces linger too long.

Notes

The module keeps both the accumulated trail and the previous input at full resolution. Both histories clear when the output format changes, and there is no manual reset. Motion comes from frame-to-frame differences, so camera noise and hard cuts can also create traces. Smear and the two stored frames add GPU and memory cost.

Effects

Zoom Blur

Pulls the image radially toward its center to create a zoom-motion streak.

Inputs

Label	Signal	Purpose
`In`	Video	Image to blur.
`Strength`	Float/CV	Controls radial blur distance.

Outputs

Label	Signal	Purpose
`Out`	Video	Radially blurred image.

Controls

Control	Initial value	Range / step or options	Purpose
`Strength`	0.3	0–1 / 0.01	Distance sampled toward the image center.

Starting patch

Connect video to In and sweep Strength between 0.15 and 0.45.

Notes

The module keeps no frame history and preserves the source aspect ratio. It reads 51 source points for every output pixel, so it is considerably heavier than a simple distortion even at low Strength.

Effects

Chromatic Trails

Builds animated, color-separated feedback trails with independent red, green, and blue retention.

Inputs

Label	Signal	Purpose
`In`	Video	Live image fed into the trail loop.
`Mode`, `Echo Bloom`, `Prism Vortex`, `Spectral Drift`	Float/CV	Drive trail blending and movement.
`Retention R`, `Retention G`, `Retention B`, `Fade`	Float/CV	Drive per-channel and overall trail retention.

Outputs

Label	Signal	Purpose
`Out`	Video	Current chromatic trail composite.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Normal	Normal, Add, Screen, Multiply, Overlay, Diff	Blends the trailed image with the fresh frame.
`Echo Bloom`	0.35	0–1 / 0.01	Expands the animated channel drift.
`Prism Vortex`	0.2	0–1 / 0.01	Adds circular, prism-like motion.
`Retention R`, `Retention G`, `Retention B`	0.92, 0.88, 0.84	0.5–0.995 / 0.005	Per-channel previous-frame contribution.
`Fade`	0.98	0.9–1 / 0.005	Overall history brightness retention.
`Spectral Drift`	0.18	0–1 / 0.01	Separates and animates the RGB sampling paths.

Starting patch

Feed moving video into In, choose Screen, and raise Spectral Drift while leaving the three retention values slightly different.

Notes

The module keeps one full-resolution previous output, clears it when the output format changes, and has no manual reset. Drift, bloom, and vortex keep evolving while the module is active. Bright blend modes and high retention or fade can build toward white.

Effects

Edge Detect

Converts an image into adjustable Sobel or Laplacian outlines.

Inputs

Label	Signal	Purpose
`In`	Video	Image to analyze.
`Strength`, `Threshold`, `Line Width`, `Line R`, `Line G`, `Line B`, `Mode`	Float/CV	Drive edge extraction, color, and kernel choice.

Outputs

Label	Signal	Purpose
`Out`	Video	Colored edge mask on black.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Sobel	Sobel, Laplacian	Chooses the edge kernel.
`Strength`	1	0.1–5 / 0.1	Multiplies edge response.
`Threshold`	0	0–1 / 0.01	Removes weaker edges.
`Line Width`	1	0.25–8 / 0.05	Changes the kernel's texel spacing.
`Line R`, `Line G`, `Line B`	1, 1, 1	0–1 / 0.01	Edge color.
`Invert`	Off	Off, On	Inverts the final edge mask.

Starting patch

Connect a detailed source, start with Sobel, raise Threshold to remove texture noise, then tint the lines.

Notes

Output is an opaque edge image rather than the original video with an overlay. Sobel examines more neighboring pixels than Laplacian. Mode can be switched on the module but cannot currently be CV-patched there; Invert is also manual-only.

Effects

Posterize

Reduces color into graphic RGB, threshold, luminance, or hue bands.

Inputs

Label	Signal	Purpose
`In`	Video	Image to quantize.
`Levels`, `Threshold`, `Mix`, `Dither`	Float/CV	Drive the matching control. Mode has no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Posterized image.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Levels	Levels, Threshold, Luma, Hue	Quantization treatment.
`Levels`	8	2–32 / 1	Number of color or luminance bands.
`Threshold`	0.5	0–1 / 0.01	Black/white cutoff in Threshold mode; hue rotation center in Hue mode.
`Mix`	1	0–1 / 0.01	Dry/wet blend.
`Dither`	0	0–1 / 0.01	Adds ordered 4×4 dithering around band boundaries.

Starting patch

Select Levels, set Levels to 4, then add a small amount of Dither; try Hue for a more graphic palette.

Notes

Levels works per RGB channel, Luma preserves source hue while banding brightness, and Hue creates saturated hue slices. The module keeps no frame history and processes each frame once.

Effects

Optical Flow

Estimates motion between frames and uses it to warp, smear, or visualize the image.

Inputs

Label	Signal	Purpose
`In`	Video	Current frame.
`Reset`	Float/CV trigger	A rising value reaching 1 snaps smear history to the live frame.
`Scale`, `Threshold`, `Mix`	Float/CV	Drive motion amplification, gating, and wet mix. Type has no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Warped, smeared, or vector-colored result.

Controls

Control	Initial value	Range / step or options	Purpose
`Type`	Warp	Warp, Smear, Vectors	Output treatment.
`Scale`	10	0–50 / 0.5	Amplifies detected motion.
`Threshold`	0.03	0–0.3 / 0.005	Rejects small frame differences.
`Mix`	1	0–1 / 0.01	Dry/wet blend.
`Reset` button	—	Momentary	Copies the live frame into smear history.

Starting patch

Use moving camera footage, select Warp, keep Scale around 10, and raise Threshold if noise causes shimmer.

Notes

The module keeps both the previous input and smear result at full resolution and clears them when the output format changes. Motion analysis and the two stored frames add GPU and memory cost, and the module stays active even with a still input. The first frame has no motion history. Reset clears only the smear result, not the previous input used for motion detection.

Effects

Interest Mesh

Finds bright regions or corners and draws tracking boxes plus a nearest-neighbor web over the image.

Inputs

Label	Signal	Purpose
`In`	Video	Image to analyze and composite.
`Threshold`, `Max Points`, `Min Area`, `Neighbors`	Float/CV	Drive feature detection and web density.
`Line W`, `Line Soft`, `Line R`, `Line G`, `Line B`	Float/CV	Drive web thickness, softness, and color.
`Box W`, `Box R`, `Box G`, `Box B`	Float/CV	Drive box thickness and color.
`Mix`	Float/CV	Blends the source and overlay. `Mode`, `Show Box`, and `Show Web` have no CV jacks.

Outputs

Label	Signal	Purpose
`Out`	Video	Input/overlay composite.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Luma	Luma, Corners	Chooses bright-blob or Harris-corner analysis.
`Threshold`	0.45	0.02–0.98 / 0.01	Detection threshold.
`Max Points`	20	4–32 / 1	Maximum retained features.
`Min Area`	12	2–200 / 1	Minimum bright-region area in Luma mode.
`Neighbors`	3	2–8 / 1	Nearby points linked from each feature.
`Line W`, `Line Soft`	1.2, 1.2	0.4–6 / 0.1; 0–6 / 0.1	Web thickness and softness.
`Box W`	1	0.4–6 / 0.1	Box thickness.
`Mix`	0.5	0–1 / 0.01	0 is input only; 1 is overlay only on black.
`Show Box`, `Show Web`	On, On	Off, On	Enable the two overlay layers.
`Line R`, `Line G`, `Line B`	0.2, 0.95, 0.35	0–1 / 0.01	Web color.
`Box R`, `Box G`, `Box B`	1, 0.85, 0.1	0–1 / 0.01	Box color.

Starting patch

Feed in high-contrast video, start in Luma mode, tune Threshold until a few boxes appear, then raise Neighbors for a denser web.

Notes

Tracking works from a 200-pixel-wide copy and is limited to 32 features and 128 links. Analysis runs separately from drawing, so the overlay can trail fast motion by a frame or more. Noisy images can be CPU-heavy; if tracking cannot run, the input passes through unchanged.

Effects

ASCII/Halftone

Rebuilds an image as tinted halftone dots or glyphs from Patchframe's ASCII atlas.

Inputs

Label	Signal	Purpose
`In`	Video	Image that drives cell brightness.
`Mode`, `Resolution`, `Spacing`, `Contrast`, `Angle`	Float/CV	Drive mark style and layout.
`Red`, `Green`, `Blue`, `Alpha`	Float/CV	Drive mark color and opacity.

Outputs

Label	Signal	Purpose
`Out`	Video	Halftone or ASCII rendering.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Halftone	Halftone, ASCII	Selects dots or glyphs.
`Resolution`	48	4–160 / 1	Grid density.
`Spacing`	0.15	0–0.9 / 0.01	Empty space around each cell.
`Contrast`	1.2	0.5–3 / 0.1	Brightness contrast used to size/select marks.
`Angle`	0°	0–360° / 1°	Rotates the mark grid.
`Red`, `Green`, `Blue`, `Alpha`	1, 1, 1, 1	0–1 / 0.01	Output mark color and opacity.

Starting patch

Connect a portrait or bold graphic, select ASCII, lower Resolution to about 32, and increase Contrast.

Notes

ASCII mode depends on Patchframe's generated font atlas; if it cannot be created, output clears. The module keeps no frame history and processes each frame once.

Effects

Dot Screen

Converts an image into configurable print-style dots, optionally using a second video as the dot artwork.

Inputs

Label	Signal	Purpose
`In`	Video	Image that drives dot size and color separation.
`Texture`	Video	Optional image used in Window or Stamp texture mode.
`Grid Size`, `Min Dot`, `Max Dot`, `Angle`, `Contrast`, `Invert`, `Mix`	Float/CV	Drive dot scale, placement, response, and blend.
`Shape`, `Screen`, `Stamp`, `Hex`	Float/CV	Choose the mark, color-separation, texture, and grid modes.
`Softness`, `Jitter`	Float/CV	Drive edge feathering and cell variation.
`Red`, `Green`, `Blue`, `Alpha`	Float/CV	Drive screen tint and opacity.

Outputs

Label	Signal	Purpose
`Out`	Video	Dot-screen composite.

Controls

Control	Initial value	Range / step or options	Purpose
`Grid Size`	20	4–80 / 1	Dot-grid density.
`Min Dot`	0.05	0–0.49 / 0.01	Minimum dot radius within a cell.
`Max Dot`	0.42	0.01–0.49 / 0.01	Maximum dot radius within a cell.
`Angle`	45°	0–360° / 1°	Rotates the screen.
`Contrast`	1	0.5–3 / 0.05	Expands or compresses source-luma response.
`Invert`	Off	Off, On	Reverses the dot-size response.
`Mix`	1	0–1 / 0.01	Dry/wet blend; full wet produces the punch-out screen.
`Shape`	Circle	Circle, Square, Diamond, Line	Dot primitive.
`Screen`	Mono	Mono, RGB, CMYK	Single or separated print screens.
`Stamp`	Window	Window, Stamp	Samples the optional video continuously or once per cell.
`Hex`	Square	Square, Hex	Grid packing.
`Softness`, `Jitter`	0, 0	0–1 / 0.01	Edge feathering and cell-position variation.
`Red`, `Green`, `Blue`, `Alpha`	1, 1, 1, 1	0–1 / 0.01	Screen tint and opacity. Alpha is saved and CV-addressable but is not shown on the current DOTS and PRINT module pages.

Starting patch

Feed video into In, set Grid Size around 30, then try CMYK with small Jitter; connect a logo to Texture and select Stamp.

Notes

Without a Texture input, Window and Stamp use solid white. The DOTS and PRINT pages only reorganize controls; hidden parameters remain active. The module keeps no frame history and processes each frame once.

Effects

Delay Buffer

Records a rolling frame history and exposes three independently timed, mixed, and reversible read heads.

Inputs

Label	Signal	Purpose
`In`	Video	Live frame written to the shared ring buffer.
`Frames`, `Freeze`	Float/CV	Drive shared history capacity and recording state.
`Delay`, `Mix`, `Reverse`, `Patch BPM`, `Beats`	Float/CV	Drive tap 1 timing, blend, direction, and sync.
`Delay 2`, `Mix 2`, `Reverse 2`, `Patch BPM 2`, `Beats 2`	Float/CV	Drive tap 2 timing, blend, direction, and sync.
`Delay 3`, `Mix 3`, `Reverse 3`, `Patch BPM 3`, `Beats 3`	Float/CV	Drive tap 3 timing, blend, direction, and sync.

Outputs

Label	Signal	Purpose
`Out`, `Out 2`, `Out 3`	Video	Independent delayed tap results.

Controls

Control	Initial value	Range / step or options	Purpose
`Frames`	15	2–60 / 1	Requested shared history capacity.
`Freeze`	Off	Off, On	Stops new frame writes while the read heads continue.
`Delay`, `Delay 2`, `Delay 3`	5 frames	0–59 / 1	Free-running delay for each tap.
`Mix`, `Mix 2`, `Mix 3`	1	0–1 / 0.01	Live/delayed blend for each tap.
`Reverse`, `Reverse 2`, `Reverse 3`	Off	Off, On	Reads from the oldest side of available history.
`Patch BPM`, `Patch BPM 2`, `Patch BPM 3`	Off	Off, On	Replaces frame delay with patch-tempo timing.
`Beats`, `Beats 2`, `Beats 3`	1	1/32, 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, 16, 32	Tempo division for each synchronized tap.

Starting patch

Connect moving video, keep Frames at 15, set the three delays to 3, 8, and 14, then route the outputs into a mixer.

Notes

All taps share one full-resolution history whose memory use is capped at 256 MiB. At high output resolutions the module may retain fewer than the requested frames, and longer delays clamp to the history available. Fractional tempo delays blend adjacent frames. An output-format change clears history; Freeze preserves what is already stored. The TAPE and TAPS pages only choose which controls and jacks are visible.

Effects

Multiply

Repeats an image as a grid, layered overlay, or mirrored mosaic, with optional per-instance temporal staggering.

Inputs

Label	Signal	Purpose
`In`	Video	Image to repeat.
`Mode`, `Blend`, `Cols`, `Rows`, `Scale`, `Offset X`, `Offset Y`, `Opacity`, `Jitter`	Float/CV	Drive layout, compositing, position, and variation.
`Delay`, `Beats`, `BPM Sync`, `Shuffle delay`, `Reverse order`	Float/CV	Drive temporal spacing and order.

Outputs

Label	Signal	Purpose
`Out`	Video	Multiplied image.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Grid	Grid, Overlay, Mosaic	Repeat layout.
`Blend`	Normal	Normal, Add, Screen, Multiply, Overlay, Diff	Instance compositing mode.
`Cols`, `Rows`	2, 2	1–16 / 1	Grid dimensions.
`Scale`	25	1–100 / 1	Instance scale; 25 is 100% and 100 is 400%.
`Offset X`, `Offset Y`	0, 0	−1–1 / 0.01	Shifts the repeated layout.
`Delay`	0	−50–50 / 0.5	Per-instance history order and distance in free-run mode.
`Beats`	1	1/32, 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, 16, 32	Synchronized frame spacing between instances.
`Reverse order`	Off	Off, On	Reverses synchronized delay order.
`Opacity`	100%	0–100 / 1	Per-instance alpha.
`Jitter`	0%	0–100 / 1	Stable instance-position variation.
`BPM Sync`	Off	Off, On	Uses patch BPM and Beats instead of Delay magnitude.
`Shuffle delay`	Off	Off, On	Applies a stable shuffled temporal order.

Starting patch

Choose Grid, set 4 columns by 3 rows, then add a small Delay; try Mosaic with Shuffle delay for a more irregular wall.

Notes

With Delay near zero and BPM Sync off, the module releases its history and uses less memory. Temporal mode can keep up to 64 full-resolution frames, so high output resolutions are memory-heavy. Large row and column counts also increase GPU work substantially. BPM Sync rounds temporal spacing to whole rendered frames, so timing precision depends on frame rate. Mode, Blend, BPM Sync, Shuffle delay, and Reverse order can be changed on the module but cannot currently be CV-patched there.

Effects

Echo

Builds a cascade of transformed image copies with spatial, color, opacity, and temporal decay.

Inputs

Label	Signal	Purpose
`In`	Video	Image copied through the cascade.
`Count`, `Spread X`, `Spread Y`, `Rot Spread`, `Scale Decay`, `Alpha Decay`, `Blend`, `Hue Drift`, `Delay`, `Beats`, `Origin X`, `Origin Y`	Float/CV	Drive the matching echo control. BPM Sync and Address have no CV jacks.

Outputs

Label	Signal	Purpose
`Out`	Video	Echo cascade.

Controls

Control	Initial value	Range / step or options	Purpose
`Count`	5	1–32 / 1	Number of copies.
`Spread X`, `Spread Y`	0.1, 0	−1–1 / 0.01	Position increment per copy.
`Rot Spread`	0.1	−3.14–3.14 / 0.01	Rotation increment in radians.
`Scale Decay`	0.9	0.1–2 / 0.01	Scale multiplier across copies.
`Alpha Decay`	0.7	0.1–1 / 0.01	Opacity multiplier across copies.
`Blend`	Normal	Normal, Add, Screen, Multiply, Overlay, Diff	Copy blend mode.
`Hue Drift`	0°	−180–180° / 1°	Hue change per copy.
`Delay`	0 frames	0–16 / 0.5	History offset per copy.
`Beats`	1/4	1/32, 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, 16, 32	Patch-tempo spacing in BPM mode.
`BPM Sync`	Off	Off, On	Uses Beats and patch BPM for copy timing.
`Address`	Clamp	Clamp, Wrap, Mirror	Sampling outside the image.
`Origin X`, `Origin Y`	0.5, 0.5	0–1 / 0.01	Transform origin.

Starting patch

Set Count to 8, Spread X to 0.06, Alpha Decay near 0.75, and add a small positive Rot Spread.

Notes

Delay below 0.5 frame with BPM Sync off avoids keeping history. Temporal mode can keep up to 64 full-resolution frames and clears them when the output format changes. BPM Sync limits Count to 1, 2, 4, 8, 16, or 32 and distributes rotation as whole turns across that count. High Count is GPU-heavy; bright blend modes can saturate quickly.

Effects

Perispheric

Wraps a rectangular image around a polar planet or tunnel projection.

Inputs

Label	Signal	Purpose
`In`	Video	Image to wrap.
`Strength`, `Rotate`, `Zoom`, `Offset`	Float/CV	Drive the projection. Type has no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Polar-wrapped image.

Controls

Control	Initial value	Range / step or options	Purpose
`Type`	Planet	Planet, Tunnel	Chooses whether the source's top or bottom edge maps to the projection center.
`Strength`	1	0–1 / 0.01	Blends from the original image to the polar mapping.
`Rotate`	0 turns	0–1 / 0.01	Rotates one full turn around the projection.
`Zoom`	1	0.25–4 / 0.01	Changes planet/tunnel scale.
`Offset`	0	0–1 / 0.01	Scrolls and wraps the source along its radial axis.

Starting patch

Connect a panoramic or striped source, select Planet, set Strength to 1, then rotate and offset it slowly.

Notes

Strength 0 returns to the original image mapping. Outside the polar disc is transparent at full strength. The module keeps no frame history, preserves the source aspect ratio, and processes each frame once.

Effects

Fish Eye

Applies an adjustable equidistant fisheye or inverse-fisheye lens projection around a movable center.

Inputs

Label	Signal	Purpose
`In`	Video	Image to distort.
`Strength`, `Zoom`, `Center X`, `Center Y`	Float/CV	Drive the lens projection.

Outputs

Label	Signal	Purpose
`Out`	Video	Lens-distorted image.

Controls

Control	Initial value	Range / step or options	Purpose
`Strength`	0.5	−1–1 / 0.01	Positive fisheye, zero neutral lens, negative inverse distortion.
`Zoom`	1	0.25–4 / 0.01	Lens magnification.
`Center X`, `Center Y`	0.5, 0.5	0–1 / 0.01	Lens center.

Starting patch

Connect a grid or face, set Strength around 0.65, and move Center X/Y toward the subject.

Notes

Zoom and center still affect the image when Strength is zero. The projection preserves the source aspect ratio, repeats edge pixels outside the image, and keeps no frame history.

Effects

Wave

Animates a sine-wave displacement horizontally, vertically, or on both axes.

Inputs

Label	Signal	Purpose
`In`	Video	Image to ripple.
`Amplitude`, `Frequency`, `Speed`, `Direction`	Float/CV	Drive the matching wave control.

Outputs

Label	Signal	Purpose
`Out`	Video	Wave-distorted image.

Controls

Control	Initial value	Range / step or options	Purpose
`Amplitude`	0.5	0–2 / 0.01	Displacement strength.
`Frequency`	4	1–20 / 0.5	Number/tightness of waves.
`Speed`	1	0–4 / 0.1	Time animation rate.
`Direction`	Horizontal	Horizontal, Vertical, Both	Displacement axis.

Starting patch

Connect video, set Amplitude around 0.25 and Frequency around 6, then try Both with a slow Speed.

Notes

Speed 0 freezes the phase. A nonzero value keeps the wave animating even when the input is still. The module keeps no frame history and preserves the source aspect ratio.

$Refraction faceplate$

Effects

Refraction

Distorts an image through animated heat, ripple, glass, prism, or twist fields.

Inputs

Label	Signal	Purpose
`In`	Video	Image to refract.
`Strength`, `Scale`, `Speed`, `Angle`, `Chromatic`, `Mix`	Float/CV	Drive the matching distortion control. Function has no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Refracted image.

Controls

Control	Initial value	Range / step or options	Purpose
`Function`	Heat	Heat, Ripple, Glass, Prism, Twist	Distortion field.
`Strength`	0.5	0–2 / 0.01	Refraction displacement.
`Scale`	20	5–60 / 1	Spatial frequency/detail.
`Speed`	1	0–2 / 0.01	Animation rate.
`Angle`	0 turns	0–1 / 0.01	Distortion direction/rotation.
`Chromatic`	0	0–1 / 0.01	RGB separation.
`Mix`	1	0–1 / 0.01	Dry/wet blend.

Starting patch

Select Heat, set Strength near 0.4 and Speed around 0.5; add Chromatic sparingly.

Notes

With Mix above zero, nonzero Speed animates whenever Strength or Chromatic is active. Speed 0 produces a static field. The module keeps no frame history; Glass, Prism, and other multi-lookup functions can cost more GPU time than simpler distortions.

Effects

Crystal Distortion

Breaks an image into prismatic crystal facets, with triggerable pattern changes and optional audio response.

Inputs

Label	Signal	Purpose
`In`	Video	Image to fracture.
`Trig`	Float/CV trigger	Each rising edge advances to a new deterministic facet variation.
`Audio`	Audio	Optional audio frame used for RMS response.
`Amount`, `Facets`, `Depth`, `Scatter`, `Rotation`	Float/CV	Drive facet shape and movement.
`Dispersion`, `Edges`, `Seed`, `Audio React`, `Mix`	Float/CV	Drive color separation, highlights, variation, reaction, and blend.

Outputs

Label	Signal	Purpose
`Out`	Video	Crystal-distorted image.

Controls

Control	Initial value	Range / step or options	Purpose
`Amount`	0.55	0–1 / 0.01	Overall facet distortion.
`Facets`	6	1–10 / 1	Facet count/detail.
`Depth`	0.35	0–1 / 0.01	Geometric depth.
`Scatter`	0.25	0–1 / 0.01	Facet displacement variation.
`Rotation`	0.15	−1–1 / 0.01	Facet-field rotation.
`Dispersion`	0.3	0–1 / 0.01	Prismatic RGB separation.
`Edges`	0.4	0–1 / 0.01	Crystal edge highlight.
`Seed`	0	0–999 / 1	Base deterministic pattern seed.
`Audio React`	0.5	0–1 / 0.01	Adds audio energy to depth, scatter, dispersion, and edges.
`Mix`	1	0–1 / 0.01	Dry/wet blend.

Starting patch

Connect video to In, set Facets to 5–7, and send occasional triggers to Trig; connect Audio Follow's Audio output to Audio for reactive dispersion.

Notes

Audio comes only from the Audio jack, so capture permission and device choice belong to the upstream audio module. The response has a short attack and release tail that can keep the module active briefly after sound stops. Each trigger advances Seed through a repeatable sequence. The module stores no video history.

Effects

Reality Fold

Folds an image through recursive portals and topology changes, with feedback memory, beat-length gestures, triggers, and audio response.

Inputs

Label	Signal	Purpose
`In`	Video	Image to fold.
`Trig`	Float/CV trigger	When connected, a rising edge starts a new fold/topology gesture.
`Audio`	Audio	Optional bass and full-band reaction source.
`Fold`, `Depth`, `Portals`, `Recursion`, `Perspective`, `Twist`	Float/CV	Drive portal structure and deformation.
`Memory`, `Edge Light`, `Audio React`, `Mix`, `Beats`	Float/CV	Drive feedback, highlights, reaction, blend, and gesture timing.

Outputs

Label	Signal	Purpose
`Out`	Video	Folded portal composite.

Controls

Control	Initial value	Range / step or options	Purpose
`Fold`	0.55	0–1 / 0.01	Overall folding deformation.
`Depth`	0.45	0–1 / 0.01	Portal depth.
`Portals`	4	1–8 / 1	Number of portal sectors.
`Recursion`	0.55	0–1 / 0.01	Nested portal repetition.
`Perspective`	0.1	−1–1 / 0.01	Forward/backward perspective tension.
`Twist`	0.15	−1–1 / 0.01	Continuous topology twist.
`Memory`	0.35	0–0.95 / 0.01	Previous-output contribution.
`Edge Light`	0.45	0–1 / 0.01	Portal/fold highlight.
`Audio React`	0.5	0–1 / 0.01	Scales bass/full-band modulation.
`Mix`	1	0–1 / 0.01	Dry/wet blend.
`Beats`	1	1/4, 1/2, 1, 2, 4, 8	Gesture duration from patch tempo.

Starting patch

Feed in a geometric source, keep Fold and Recursion near their defaults, and leave Trig disconnected for autonomous beat-synced topology changes.

Notes

With Trig disconnected, topology gestures cycle automatically from the patch beat; connecting it stops that clock, and rising edges launch gestures of the selected Beats length. Bass increases depth, portal scale, and perspective; full-band energy raises edge light and memory. The module keeps one full-resolution previous output, clears it when the output format changes, and has no manual reset. Memory, Twist, automatic motion, trigger tails, and audio release can keep the module active. Fold 0 or Mix 0 returns the dry image, but history still updates for later use.

Effects

Glow

Adds outer or inner bloom with thresholding, hue rotation, directional streaks, prism separation, and sparkles.

Inputs

Label	Signal	Purpose
`In`	Video	Image to bloom.
`Radius`, `Intensity`, `Threshold`, `Tint`, `Streak`, `Angle`, `Prism`, `Sparkle`	Float/CV	Drive glow appearance. Inner has no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Glowing image.

Controls

Control	Initial value	Range / step or options	Purpose
`Inner`	Off	Off, On	Draws glow inward rather than around bright regions.
`Radius`	8	1–30 / 1	Blur spread.
`Intensity`	0.5	0–2 / 0.01	Glow brightness.
`Threshold`	0	0–1 / 0.01	Minimum source luminance included.
`Tint`	0 turns	0–1 / 0.01	Rotates glow hue through one full turn.
`Streak`	0	0–1 / 0.01	Stretches the kernel directionally.
`Angle`	0 turns	0–1 / 0.01	Streak direction.
`Prism`	0	0–1 / 0.01	Separates glow colors along the streak.
`Sparkle`	0	0–1 / 0.01	Adds time-varying bright specks.

Starting patch

Raise Threshold to isolate highlights, set Radius around 10 and Intensity near 0.7, then add a small Streak.

Notes

Larger Radius values read more neighboring pixels, up to nine steps, and increase GPU work. Sparkle keeps changing while the module is active. The module keeps no frame history.

Effects

Hula

Unshuffles an image into strips — a riffle shuffle in reverse — by dealing columns, rows, or both into division groups.

Reference

Hula refers to the work of artist and poet Jiří Hůla (1944–2022), who developed a method of rearranging visual information units.

Jiří Hůla, rearrangement of visual information units

Inputs

Label	Signal	Purpose
`In`	Video	Image to unshuffle.
`Rev`	Float/CV trigger	Rising-edge trigger that toggles Reverse.
`Strips`, `Division`, `Mode`, `Mix`, `Offset`, `Delay`, `Beats`	Float/CV	Drive the matching control. Reverse and BPM Sync have no CV jack.

Outputs

Label	Signal	Purpose
`Out`	Video	Unshuffled image.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`	Columns	Columns, Rows, Both	Axis to slice.
`Strips`	16	2–64 / 1	Strips per axis.
`Division`	2	2–16 / 1	Deal into this many groups (2 = odd/even).
`Mix`	1	0–1 / 0.01	0 is the original, 1 is the full unshuffle.
`Offset`	0	0–1 / 0.01	Rotates which strip maps to which.
`Delay`	0	0–16 / 0.5	Frames of delay between neighboring strips.
`BPM Sync`	Off	Off, On	Syncs strip delay to patch BPM.
`Beats`	1/4	1/32, 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, 16, 32	Delay step when BPM Sync is on.
`Reverse`	Off	Off, On	Flips strip order.

Starting patch

Connect a source to In, keep Mode on Columns and Division at 2, lower Mix to 0, then sweep it toward 1.

Notes

Delay above about half a frame (or BPM Sync) keeps a 64-frame strip history, so neighboring bands can come from earlier moments. Reverse can be toggled with the Reverse control or from a rising edge on Rev.

Effects

Time Slice

Creates slit-scan images by assigning a different frame age to each row or column strip.

Inputs

Label	Signal	Purpose
`In`	Video	Live image written to history.
`Slices`, `Span`, `Offset`, `Mix`	Float/CV	Drive strip count, history range, phase, and blend. Axis and Reverse have no CV jacks.

Outputs

Label	Signal	Purpose
`Out`	Video	Slit-scan composite.

Controls

Control	Initial value	Range / step or options	Purpose
`Axis`	Rows	Rows, Columns	Strip orientation.
`Slices`	16	2–64 / 1	Number of time strips.
`Span`	32 frames	0–63 / 1	Oldest history age across the image.
`Offset`	0	0–1 / 0.01	Wraps the age ramp across strips.
`Mix`	1	0–1 / 0.01	Dry/wet blend.
`Reverse`	Off	Off, On	Reverses the age ramp.

Starting patch

Use a moving subject, select Columns, set Slices to 24 and Span near 40, then sweep Offset.

Notes

Once input arrives, the module keeps up to 64 full-resolution frames, making it one of the more memory-intensive effects. History clears when the output format changes and fills gradually, so a fresh module can use only the frames recorded so far. There is no Freeze or manual reset.

Effects

Crop

Cuts transparent margins from each edge, then repositions the remaining image without stretching it.

Inputs

Label	Signal	Purpose
`In`	Video	Image to crop.
`Left`, `Right`, `Bottom`, `Top`, `Pos X`, `Pos Y`	Float/CV	Drive the matching crop or position control.

Outputs

Label	Signal	Purpose
`Out`	Video	Cropped image with transparent cut areas.

Controls

Control	Initial value	Range / step or options	Purpose
`Left`, `Right`, `Bottom`, `Top`	0	0–1 / 0.01	Fraction removed inward from each edge.
`Pos X`, `Pos Y`	0	−1–1 / 0.01	Repositions the kept region.

Starting patch

Connect a source, trim Left and Right slightly, then use Pos X to align the remaining subject.

Notes

The kept region stays at its original size; Crop does not stretch it to fill the frame. Right and Top measure inward from the far edge. The module keeps no frame history and processes each frame once.

Effects

LUT

Applies a built-in color grade or a user-loaded 3D .cube lookup table, with basic pre/post adjustments.

Inputs

Label	Signal	Purpose
`In`	Video	Image to grade.
`LUT`, `Intensity`, `Exposure`, `Saturation`, `Contrast`	Float/CV	Drive preset selection and grading controls.

Outputs

Label	Signal	Purpose
`Out`	Video	Graded image.

Controls

Control	Initial value	Range / step or options	Purpose
`LUT`	Identity	Identity, Film, Vivid, Cool, Warm, Matte, B&W, Sunset, File	Built-in procedural grade or loaded file.
`Intensity`	1	0–1 / 0.01	Original/graded blend.
`Exposure`	0 EV	−2–2 / 0.01	Pre-LUT exposure offset.
`Saturation`	1	0–2 / 0.01	Post-LUT saturation.
`Contrast`	1	0–4 / 0.01	Post-LUT contrast.
`LOAD .CUBE`	—	File picker	Loads an Adobe/Resolve-style 3D `.cube` file and selects File.
Clear file (`×`)	—	Button	Releases the file and returns to Identity.

Starting patch

Connect video, choose Film or Warm, and lower Intensity; load a .cube only after confirming the built-in path.

Notes

File loading happens in the background. Patchframe remembers access to the selected file so a preset can reopen it; moving, deleting, or denying access to the file prevents reload. Only 3D .cube files with a valid LUT_3D_SIZE and the required RGB entries are accepted; 1D or malformed files are not. If File is selected without a valid loaded LUT, Identity is used. No camera, microphone, or network permission is involved. LUT can be changed from the module menu but cannot currently be CV-patched there.

Effects

Sample & Hold

Samples and holds video, CV, or both from an internal clock, trigger, gate, or SAMPLE button.

Inputs

Label	Signal	Purpose
`Video In`	Video	Live video to capture.
`CV In`	Float/CV	Live control value to capture.
`Trig`	Float/CV trigger	Rising edge above 0.5 captures once.
`Gate`	Float/CV gate	Tracks while high and freezes while low.
`Patch BPM`, `BPM`, `Beats`, `Mix`, `Glide`	Float/CV	Drive timing and output transition controls. Capture has no CV jack.

Outputs

Label	Signal	Purpose
`Video Out`	Video	Live/held video blend.
`CV Out`	Float/CV	Held or slewed CV value.

Controls

Control	Initial value	Range / step or options	Purpose
`Patch BPM`	On	Off, On	Uses patch tempo instead of the local BPM.
`BPM`	120	20–300 / 1	Local clock tempo when Patch BPM is off.
`Beats`	1	1/32, 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, 16, 32	Clock multiplier/division.
`Capture`	Both	Both, Video, CV	Selects which signal is updated by sampling.
`Mix`	1	0–1 / 0.01	Live/held video blend; it does not change CV capture.
`Glide`	0	0–1 / 0.01	Crossfades video holds and slews CV; maps to 0–1.5 seconds.
`SAMPLE`	—	Momentary	Captures immediately regardless of clock wiring.

Starting patch

Connect video and an LFO to the two inputs, leave Capture on Both, and adjust Glide while the internal clock samples automatically; connect Trig when you want explicit captures instead.

Notes

When neither Trig nor Gate is connected, the internal clock runs. Connecting either suppresses it: Gate high tracks continuously, Gate low holds, and a Trig rising edge captures when not tracking. A fresh module outputs CV 0 and has no held video until the first capture; its held and glide-from videos clear when the output format changes. The module stores two full-resolution videos. Patch BPM follows the patch/Link beat, while local BPM advances with rendered frames.

Modulators

LFO

Generates a repeating or random control signal for continuously animating another module.

Inputs

Label	Signal	Purpose
`Waveform`	Float/CV	Selects Sine, Triangle, Saw, Rev Saw, Square, Random, or Glide.
`Rate Hz`	Float/CV	Sets the free-running base rate.
`BPM Sync`	Float/CV switch	Selects free-running or patch-tempo timing.
`Beats`	Float/CV	Selects the timing multiplier/division in either timing mode.
`Phase`	Float/CV	Offsets the waveform around its cycle.
`Min`, `Max`	Float/CV	Set the output range.

Outputs

Label	Signal	Purpose
`Out`	Float/CV	Oscillator value mapped between Min and Max.

Controls

Control	Initial value	Range / step or options	Purpose
`Waveform`	Sine	Sine, Triangle, Saw, Rev Saw, Square, Random, Glide	Chooses the oscillator shape.
`Rate Hz`	1 Hz	0.01–10 / 0.01	Free-running base rate.
`BPM Sync`	Off	Off, On	Locks the cycle to the patch beat grid.
`Beats`	1	1/32, 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, 16, 32	Multiplies or divides the clock.
`Phase`	0°	−180–180 / 1°	Moves the waveform earlier or later in its cycle.
`Min`	0	0–1 / 0.01	Output at the waveform minimum.
`Max`	1	0–1 / 0.01	Output at the waveform maximum.

Starting patch

Connect Out to an effect’s Mix, Amount, or position CV input. Start with Sine, set Min to 0.2 and Max to 0.8, then adjust Rate Hz.

Notes

The output is normally 0–1, but setting Min above Max reverses it. Beats remains active in both timing modes: at the default Beats value of 1 it multiplies the free rate by 1/4, or produces one BPM-synced cycle every four beats; 1/4 produces one cycle per beat. BPM Sync follows the patch/Link beat and ignores Rate Hz. Random holds one repeatable value for each cycle, while Glide smoothly interpolates between repeatable random targets. Square and Random jump abruptly. This is a lightweight control-only module with no trigger/reset input; phase restarts only when the shared beat or render timeline does.

Modulators

Audio Follow

Turns microphone, line, desktop/app, or Link Audio into wideband, frequency-band, pitch, and stereo-audio signals.

Inputs

Label	Signal	Purpose
`Gain`, `Low Gain`, `Mid Gain`, `High Gain`	Float/CV	Set wideband or per-band sensitivity.
`Low-Mid Hz`, `Mid-High Hz`	Float/CV	Set the low/mid and mid/high crossover frequencies.
`Smoothing`	Float/CV	Smooths all six CV analysis outputs.
`Min`, `Max`	Float/CV	Remap all CV analysis outputs.

Outputs

Label	Signal	Purpose
`Out`	Float/CV	Selected-channel wideband level after Gain.
`Low`, `Mid`, `High`	Float/CV	Three frequency-band levels after their matching gains.
`Full`	Float/CV	Wideband level without the main Gain multiplication.
`FQ CV`	Float/CV	Detected frequency mapped logarithmically from roughly 20–2,000 Hz.
`Audio`	Audio	Stereo audio from the selected source for audio-capable modules or recording.

Controls

Control	Initial value	Range / step or options	Purpose
`Source`	Microphone / line in	Microphone / line in, Desktop audio (ScreenCaptureKit), Link Audio	Chooses the capture route.
`Device`	System Default	System Default plus available hardware inputs	Chooses a hardware source when applicable.
`App Audio`	All desktop audio	All desktop audio or a currently capturable app	Narrows desktop capture; Refresh restarts capture and updates the app list.
`Link Audio`	No channel selected	Discovered Link Audio channels; Refresh channels	Chooses a Link Audio peer/channel.
`Channel`	Ch 1	Available source channels	Chooses the channel used for CV analysis.
`Gain`	1	0.1–10 / 0.1	Scales Out and also raises the signal before pitch detection.
`Low-Mid Hz`	250 Hz	20–2,000 / 1 Hz	Low/mid crossover.
`Mid-High Hz`	4,000 Hz	500–20,000 / 10 Hz	Mid/high crossover.
`Low Gain`, `Mid Gain`, `High Gain`	1	0.1–10 / 0.1	Scale the matching band output.
`Smoothing`	0.35	0–0.99 / 0.01	0 responds immediately; larger values settle more slowly.
`Min`	0	0–1 / 0.01	Mapped CV floor.
`Max`	1	0–1 / 0.01	Mapped CV ceiling.

Starting patch

Select a source, play steady audio, and connect Out to an effect’s Mix. Raise Gain until the level meter moves clearly without staying pinned; use Low instead when you want kick or bass response.

Notes

Microphone/line capture requires macOS microphone permission. Desktop/app capture requires Screen & System Audio Recording permission and may need a restart after permission changes. Link Audio requires a visible peer/channel. If capture is stopped, denied, silent, or unavailable, CV falls toward Min and Audio can be empty. Keep Low-Mid Hz below Mid-High Hz for meaningful bands. Min and Max affect the six float outputs but not the raw stereo Audio output; Gain affects Out and pitch detection, band gains affect only their bands, and Full remains the ungained wideband reference. FQ CV uses a fixed musical low-frequency mapping rather than the displayed crossover values. Audio analysis and capture are shared services, so source changes can restart capture; the module itself performs no video work.

Modulators

Freq Follower

Converts the detected pitch of one hardware audio channel into a smoothed control value.

Inputs

Label	Signal	Purpose
`Freq Min`, `Freq Max`	Float/CV	Set the pitch range mapped to 0–1.
`Log`	Float/CV	Blends from linear to logarithmic pitch mapping.
`Gain`	Float/CV	Raises audio before the pitch detector’s silence gate.
`Smoothing`	Float/CV	Smooths the mapped pitch.
`Min`, `Max`	Float/CV	Set the final output range.

Outputs

Label	Signal	Purpose
`Out`	Float/CV	Detected pitch mapped between Min and Max.

Controls

Control	Initial value	Range / step or options	Purpose
`Device`	System Default	System Default plus available hardware inputs	Chooses the shared hardware input device.
`Channel`	Ch 1	Available active channels	Chooses the channel to analyze.
`Freq Min`	80 Hz	20–2,000 / 1 Hz	Pitch mapped to the bottom of the range.
`Freq Max`	2,000 Hz	100–8,000 / 1 Hz	Pitch mapped to the top of the range and the detector’s upper search limit.
`Log`	0	0–1 / 0.01	0 is linear; 1 is logarithmic; intermediate values blend the two.
`Gain`	1	0.1–10 / 0.1	Pre-gain for detecting quiet pitches.
`Smoothing`	0.85	0–0.99 / 0.01	Higher values reduce jitter but add lag.
`Min`	0	0–1 / 0.01	Output floor.
`Max`	1	0–1 / 0.01	Output ceiling.

Starting patch

Feed a clean monophonic tone into Ch 1, set Freq Min and Freq Max around the expected notes, then connect Out to a color or position control. Increase Gain only if the frequency readout often disappears.

Notes

This module needs running hardware audio capture and macOS microphone permission; it does not select desktop/app or Link Audio. Device selection changes the shared audio device. Silence or an undetectable/ambiguous pitch maps toward Min. Pitch tracking works best on a single stable note and can jump by octaves on chords, noise, transients, or weak fundamentals. Keep Freq Min below Freq Max. Gain improves detection threshold but is not a post-map output multiplier. Smoothing is frame-updated, so its perceived settling time also depends on render rate.

Modulators

Timeline

Generates a tempo-aware ramp, ping-pong, stepped-random value, or editable multi-point envelope.

Inputs

Label	Signal	Purpose
`BPM Sync`, `Rate Hz`, `Beats`	Float/CV	Drive timing mode, free rate, and clock multiplier/division.
`Start`, `End`	Float/CV	Set the simple ramp range when Envelope is off.
`Envelope`	Float/CV switch	Enables the editable envelope.
`Dir`, `EnvCount`	Float/CV	Stored ports for direction and point count. The current Timeline module does not show these two jacks.
`Env0`, `Env1`, `Env2`, `Env3`, `Env4`, `Env5`, `Env6`, `Env7`, `Env8`, `Env9`, `Env10`, `Env11`	Float/CV	Stored ports for envelope point values. The module edits points directly and does not show these jacks.
`Env1Pos`, `Env2Pos`, `Env3Pos`, `Env4Pos`, `Env5Pos`, `Env6Pos`, `Env7Pos`, `Env8Pos`, `Env9Pos`, `Env10Pos`	Float/CV	Stored ports for internal point positions. The module does not show these jacks.

Outputs

Label	Signal	Purpose
`Out`	Float/CV	Current ramp, random, or envelope value.

Controls

Control	Initial value	Range / step or options	Purpose
`BPM Sync`	On	Off, On	Uses the patch beat grid instead of wall-clock time.
`Speed` (`Rate Hz`)	1 Hz	0.01–30 / 0.01	Free-running base rate when BPM Sync is off.
`Beats`	1	1/32, 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, 16, 32	Multiplies or divides the cycle rate.
`Envelope`	Off	Off, On	Switches between Start/End mapping and the point editor.
`Start`	0	0–1 / 0.01	First end of the simple range.
`End`	1	0–1 / 0.01	Other end of the simple range; Start above End reverses it.
Direction	Forward	Forward, Backward, Ping-Pong, Random	Chooses the cycle traversal; the icon selector is the only visible direction control.
Envelope points	5 points: (0, 0), (0.25, 0.25), (0.5, 0.5), (0.75, 0.75), (1, 1)	2–12 points; value 0–1 / 0.01; internal position 0–1 / 0.01	Drag to edit. Double-click empty space to add; double-click or select/delete an internal point to remove it. Endpoints stay at positions 0 and 1.

Starting patch

Connect Out to a blend Mix, leave BPM Sync on and Beats at 1, then choose Ping-Pong. Turn on Envelope and drag the middle points to make a repeating rise-and-fall gesture.

Notes

At Beats 1 the default BPM-synced cycle lasts four beats; Beats 1/4 gives one cycle per beat. In free mode Rate Hz is still multiplied by Beats. BPM timing is phase-locked to the shared beat; free timing follows the render timeline. Random holds one deterministic value per cycle. When Envelope is on, Start and End are ignored and the selected direction is applied before linear interpolation through the envelope points. Points snap near the visible time/value grid, but there is no trigger, one-shot, hold, or manual reset input. Although runtime CV ports exist for direction and the complete stored envelope schema, the dedicated module currently exposes jacks only for BPM Sync, Rate Hz, Beats, Envelope, Start, and End; hidden ports are mainly relevant to restored or programmatically built patches.

Modulators

Step Seq

Plays up to 16 programmed CV levels and can emit selected per-step trigger pulses.

Inputs

Label	Signal	Purpose
`Next`	Float/CV trigger	When connected, each rising edge advances one step and replaces clock-driven advancement.
`Steps`, `Swing`, `Beats`, `Patch BPM`, `BPM`	Float/CV	Drive sequence length and timing.
`S1`, `S2`, `S3`, `S4`, `S5`, `S6`, `S7`, `S8`, `S9`, `S10`, `S11`, `S12`, `S13`, `S14`, `S15`, `S16`	Float/CV	Set the value stored at each step.

Outputs

Label	Signal	Purpose
`CV Out`	Float/CV	Value of the active step.
`Trig Out`	Float/CV trigger	Short 1 pulse when entering an enabled trigger step.

Controls

Control	Initial value	Range / step or options	Purpose
`Steps`	8	1–16 / 1	Active sequence length; columns beyond it are muted.
`Swing`	0	−50–50 / 1	Delays alternating steps; sign chooses which half of the pair is delayed.
`S1`–`S16`	S1 = 0 through S16 = 1, evenly spaced by 1/15	0–1 / 0.01	Per-step CV values.
`Beats`	1/4	1/32, 1/16, 1/8, 1/4, 1/2, 1, 2, 4, 8, 16, 32	Step-rate multiplier/division.
`Trig 1`–`Trig 16`	Off	Off, On	Enables a Trig Out pulse on entry to that step.
`Patch BPM`	On	Off, On	Uses patch/Link tempo and beat phase.
`Speed` (`BPM`)	120 BPM	20–300 / 1	Own tempo when Patch BPM is off; visibly disabled while Patch BPM is on.

Starting patch

Keep eight steps, draw an alternating low/high shape with S1–S8, and connect CV Out to an effect. Enable Trig 1 and Trig 5, then patch Trig Out to Next on a second Step Seq for a slower linked pattern.

Notes

At Beats 1/4 the sequence advances once per beat; Beats 1 advances once per four beats. Patch BPM is phase-locked to the shared beat, while own tempo follows the render timeline. A patched Next suppresses automatic advancement after first synchronizing to the current clock step; it advances only when the input crosses from below about 0.36 to at least 0.42. Trig Out is 1 for at most 150 ms and is shortened at fast rates so another rising edge can be detected. It fires only when the active step changes, not continuously while parked. Step values are 0–1, and shortening Steps wraps the active index into the new length. There is no reset, reverse, probability, glide, or per-step duration control.

Modulators

Random

Produces two independent smooth random control signals.

Inputs

Label	Signal	Purpose
`Speed A`, `Smooth A`, `Min A`, `Max A`	Float/CV	Drive target rate, interpolation, and range for channel A.
`Speed B`, `Smooth B`, `Min B`, `Max B`	Float/CV	Drive target rate, interpolation, and range for channel B.

Outputs

Label	Signal	Purpose
`Out A`	Float/CV	Random channel A mapped between Min A and Max A.
`Out B`	Float/CV	Independently generated channel B.

Controls

Control	Initial value	Range / step	Purpose
`Speed A`, `Speed B`	1	0.1–20 / 0.1	New random targets per second.
`Smooth A`, `Smooth B`	0.5	0–0.99 / 0.01	Interpolation toward each new target.
`Min A`, `Min B`	0	0–1 / 0.01	Channel floor.
`Max A`, `Max B`	1	0–1 / 0.01	Channel ceiling.

Starting patch

Connect Out A to horizontal position and Out B to vertical position. Set both ranges narrowly around the center, then give B a slower Speed and higher Smooth value.

Notes

Each channel begins at 0.5, selects a new target according to its Speed, and eases toward it. Smooth 0 jumps directly; values near 0.99 move slowly and may never reach a target before the next one arrives. Very low or irregular frame rates can skip target-change moments. This module has no BPM sync, seed, trigger, hold, or reset control, and its random sequence is not intended for repeatable recall. Min above Max reverses the channel’s range.

$Math faceplate$

Modulators

Math

Runs two independent two-input CV calculations, then scales, offsets, and clamps each result.

Inputs

Label	Signal	Purpose
`A`, `B`	Float/CV	Signal inputs for the first calculator. Unpatched A defaults to 0; unpatched B defaults to 1.
`A 2`, `B 2`	Float/CV	Signal inputs for the second calculator with the same defaults.
`Mode`, `Gain`, `Offset`	Float/CV	Drive operation and post-processing for the first calculator.
`Mode 2`, `Gain 2`, `Offset 2`	Float/CV	Drive operation and post-processing for the second calculator.

Outputs

Label	Signal	Purpose
`Out`	Float/CV	First calculator result, clamped to 0–1.
`Out 2`	Float/CV	Second calculator result, clamped to 0–1.

Controls

Control	Initial value	Range / step or options	Purpose
`Mode`, `Mode 2`	Add	Add, Subtract, Multiply, Min, Max, Clamp, Invert	Chooses the operation.
`Gain`, `Gain 2`	1	0–4 / 0.01	Multiplies the operation result.
`Offset`, `Offset 2`	0	−1–1 / 0.01	Adds a final bias before clamping.

Starting patch

Patch an LFO to A and audio level to B, choose Multiply, and use Gain to restore the desired range. Use the second calculator for a separate modulation without adding another module.

Notes

Processing is (operation × Gain) + Offset, followed by a hard 0–1 clamp. Add is A+B; Subtract is A−B; Multiply is A×B; Min/Max select one input; Clamp limits A between 0 and B; Invert is 1−A and ignores B. Because unpatched B is 1, Multiply and Clamp pass a normal 0–1 A signal by default, while Add adds 1 and usually clips. Mode is a menu with a visible CV jack, so integer CV values can select operations. There is no smoothing, wrap, divide, modulo, comparison, or bipolar output mode.

Modulators

CV Util

Rescales, offsets, inverts, quantizes, rectifies, and frame-delays one CV signal in a fixed processing chain.

Inputs

Label	Signal	Purpose
`In`	Float/CV	Signal to process.
`Gain`, `Offset`, `Invert`, `Quantize`, `Rectify`, `Delay`	Float/CV	Drive each processing stage.

Outputs

Label	Signal	Purpose
`Out`	Float/CV	Processed, clamped, and optionally delayed signal.

Controls

Control	Initial value	Range / step or options	Purpose
`Gain`	1	−1–2 / 0.01	Scales the input; negative values reverse polarity.
`Offset`	0	−1–1 / 0.01	Adds a bias after Gain.
`Invert`	Off	Off, On	Replaces the current value with `1−value`.
`Quantize`	0	0–16 / 1	0 is off; otherwise rounds downward to increments of 1/N.
`Rectify`	Off	Off, Half, Full	Shapes the signal around a 0.5 center.
`Delay`	0	0–1 / 0.01	Selects up to 599 rendered samples of history.

Starting patch

Patch an LFO into In, set Quantize to 4 for discrete levels, then add a small Delay. Try Full rectify to turn both halves of the LFO into positive pulses.

Notes

The exact order is Gain → Offset → Invert → Quantize → Rectify → clamp to 0–1 → Delay. Half rectify discards values below 0.5 and stretches the upper half to 0–1; Full folds both halves around 0.5, doubling the apparent cycle rate. Quantize floors rather than rounds to nearest. Delay is measured in rendered samples, not seconds: the maximum is about 10 seconds at 60 fps, 20 seconds at 30 fps, and shorter at higher rates. Its fixed 600-sample history begins filled with zeros, and moving the delay can expose older values already in the buffer. There is no tempo sync, interpolation between delay taps, feedback, or manual history reset.

Modulators

CV+

Converts the rising movement of two independent CV signals into wrapping upward or downward accumulators.

Inputs

Label	Signal	Purpose
`In`, `In 2`	Float/CV	Signals whose positive frame-to-frame changes are accumulated.
`Reset`, `Reset 2`	Float/CV trigger	Rising edge above 0.5 resets the matching accumulator.
`Polarity`, `Polarity 2`	Float/CV switch	Select upward or downward accumulation.

Outputs

Label	Signal	Purpose
`Out`, `Out 2`	Float/CV	Independent wrapped accumulator values.

Controls

Control	Initial value	Options	Purpose
`Polarity`, `Polarity 2`	UP	UP, DOWN	UP adds positive input movement from 0; DOWN subtracts it from 1.
`RESET` (two buttons)	—	Momentary	Resets the matching channel on the next rendered frame.

Starting patch

Connect a saw or envelope to In and use Out to rotate or offset an effect. Leave Polarity on UP; every new rise advances the accumulated value, wrapping after 1. Use Reset to return to the start.

Notes

Inputs are sanitized to 0–1. Only positive change since the previous frame is counted; falling movement is ignored rather than subtracted. UP starts/resets at 0 and DOWN at 1. Values wrap through the 0–1 range while preserving exact endpoints. Reset is edge-triggered, so holding a Reset cable high does not repeatedly clear the value; send it low before the next reset. The on-module RESET button is separate from the Reset jack. Changing Polarity does not reset or reinterpret the amount already accumulated. There is no gain, threshold, smoothing, BPM sync, or direct initial-value control.

Modulators

Macro

Provides eight performance controls, each fanned out to eight identical CV outputs for controlling many destinations together.

Inputs

Label	Signal	Purpose
`M1`, `M2`, `M3`, `M4`, `M5`, `M6`, `M7`, `M8`	Float/CV	Replace the matching knob’s effective value and feed all eight of its outputs.

Outputs

Label	Signal	Purpose
`M1.1`–`M1.8`	Float/CV	Eight copies of M1.
`M2.1`–`M2.8`	Float/CV	Eight copies of M2.
`M3.1`–`M3.8`	Float/CV	Eight copies of M3.
`M4.1`–`M4.8`	Float/CV	Eight copies of M4.
`M5.1`–`M5.8`	Float/CV	Eight copies of M5.
`M6.1`–`M6.8`	Float/CV	Eight copies of M6.
`M7.1`–`M7.8`	Float/CV	Eight copies of M7.
`M8.1`–`M8.8`	Float/CV	Eight copies of M8.

Controls

Control	Initial value	Range / step	Purpose
`M1`, `M2`, `M3`, `M4`, `M5`, `M6`, `M7`, `M8`	0.5	0–1 / 0.01	Sets the value copied to that row’s eight outputs.

Starting patch

Connect M1.1 to one effect’s Mix and M1.2 to another effect’s Amount. Moving M1 now performs both changes together; use each destination’s range brackets to tune its response.

Notes

A CV cable into M1–M8 replaces that knob’s effective value, and every output in the matching row follows it. The current schema is fixed at eight controls and 64 outputs; there are no controls to add, remove, reorder, or rename them. Player-surface exposure, when enabled elsewhere in Patchframe, changes presentation rather than the patch connections. Macro is computationally light, but its 64 jacks can make a dense patch; unused outputs have little practical cost.

Modulators

Cable Receiver

Receives stereo audio and note events from the Patchframe AU/VST3 plugin in a DAW and exposes them as audio and CV.

Inputs

Label	Signal	Purpose
`Cable ID`	Float/CV	Chooses plugin cable 0–15; values are rounded to an integer.
`Audio format`	Float/CV switch	Selects Float or Int16 decoding for the CV/envelope reader.
`Gain`	Float/CV	Scales Envelope, Audio L, and Audio R.
`Smoothing`	Float/CV	Smooths Envelope only.

Outputs

Label	Signal	Purpose
`Envelope`	Float/CV	Smoothed RMS envelope from the left audio channel.
`Audio L`, `Audio R`	Float/CV	Absolute instantaneous amplitude of each channel, scaled by Gain.
`Stereo Audio`	Audio	Contiguous stereo stream for audio-capable modules and recording.
`MIDI Note`	Float/CV	Most recent note number divided by 127.
`MIDI Vel`	Float/CV	Most recent note velocity divided by 127; returns to 0 on note-off.
`MIDI Gate`	Float/CV gate	1 after note-on with nonzero velocity; 0 after note-off.

Controls

Control	Initial value	Range / step or options	Purpose
`Cable ID`	0	0–15 / 1	Must match the Cable ID selected in the DAW plugin.
`Audio format`	Float	Float, Int16	Must match the sample representation written by the plugin.
`Gain`	1	0.1–10 / 0.1	Scales envelope and waveform-as-CV outputs, clamped at 1.
`Smoothing`	0.85	0–0.99 / 0.01	0 reacts immediately; higher values slow Envelope response.

Starting patch

Insert the Patchframe plugin on a DAW track, set both plugin and module to Cable 0 and Float, then play audio. Connect Envelope to an effect amount and Stereo Audio to an audio-capable destination. Use MIDI Gate for note-on/off switching.

Notes

This module does not request microphone or desktop-capture permission; it depends on a running, matching Patchframe plugin and access to its local cable transport. It reconnects when Cable ID changes and retries a missing audio link periodically. The status line identifies a live link or asks you to load the plugin, and the level indicator combines the three audio-derived CV readings. Gain does not change Stereo Audio, and Smoothing affects only Envelope; Audio L/R remain fast absolute-amplitude CV. MIDI support is intentionally simple: only note-on/note-off is tracked, the last event wins, and there is no channel selector, polyphony, CC, clock, or aftertouch output. Stereo Audio is read only when that port is connected. In the current build its passthrough reader expects Float PCM even when Audio format is set to Int16, so use Float for dependable stereo routing or recording; Int16 is principally supported by the envelope and Audio L/R conversion path. Cable Receiver is unavailable without the companion plugin.

Mix / Output

Mixer 4

Composites up to four video layers in channel order.

Inputs

Label	Signal	Purpose
`Ch1`–`Ch4`	Video	Layers to composite; higher channel numbers are added later.
`Ch1 Opacity`–`Ch4 Opacity`	Float/CV	Set each layer's contribution.
`Ch1 Mode`–`Ch4 Mode`	Float/CV	Select each layer's blend operation. The current module shows mode menus but not their CV jacks.

Outputs

Label	Signal	Purpose
`Out`	Video	Four-channel composite.

Controls

Control	Initial value	Range / step or options	Purpose
`Ch1`–`Ch4 Mode`	Add	Normal, Add, Screen, Multiply, Overlay, Diff	Blend mode for each connected layer.
`Ch1`–`Ch4 Opacity`	1	0–1 / 0.01	Layer opacity; values near zero skip that layer.

Starting patch

Connect a background to Ch1 and a keyed or transparent foreground to Ch2. Change Ch2 to Normal or Screen and lower its opacity.

Notes

Unconnected and zero-opacity channels are skipped. With nothing connected, Out is transparent. Each active layer adds a full-frame blend operation, so Mixer 4 is the lightest mixer variant. Mode can be changed in the module but cannot currently be CV-patched there.

Mix / Output

Mixer 8

Composites up to eight video layers in channel order.

Inputs

Label	Signal	Purpose
`Ch1`–`Ch8`	Video	Layers to composite; higher channel numbers are added later.
`Ch1 Opacity`–`Ch8 Opacity`	Float/CV	Set each layer's contribution.
`Ch1 Mode`–`Ch8 Mode`	Float/CV	Select each layer's blend operation. The current module shows mode menus but not their CV jacks.

Outputs

Label	Signal	Purpose
`Out`	Video	Eight-channel composite.

Controls

Control	Initial value	Range / step or options	Purpose
`Ch1`–`Ch8 Mode`	Add	Normal, Add, Screen, Multiply, Overlay, Diff	Blend mode for each connected layer.
`Ch1`–`Ch8 Opacity`	1	0–1 / 0.01	Layer opacity; values near zero skip that layer.

Starting patch

Build a four-layer composite first, then use Ch5–Ch8 for accents or alternate looks that you fade in with CV.

Notes

Behavior matches Mixer 4, with four additional channels. Only connected, visible layers are processed, but a fully populated Mixer 8 can require twice as many full-frame blends. Mode can be changed in the module but cannot currently be CV-patched there.

Mix / Output

Mixer 16

Composites up to sixteen video layers in one wide mixer.

Inputs

Label	Signal	Purpose
`Ch1`–`Ch16`	Video	Layers to composite in ascending channel order.
`Ch1 Opacity`–`Ch16 Opacity`	Float/CV	Set each layer's contribution.
`Ch1 Mode`–`Ch16 Mode`	Float/CV	Select each layer's blend operation. The current module shows mode menus but not their CV jacks.

Outputs

Label	Signal	Purpose
`Out`	Video	Sixteen-channel composite.

Controls

Control	Initial value	Range / step or options	Purpose
`Ch1`–`Ch16 Mode`	Add	Normal, Add, Screen, Multiply, Overlay, Diff	Blend mode for each connected layer.
`Ch1`–`Ch16 Opacity`	1	0–1 / 0.01	Layer opacity; values near zero skip that layer.

Starting patch

Reserve channel ranges for roles—for example 1–4 backgrounds, 5–8 subjects, and 9–16 accents—then animate only the opacity controls you need.

Notes

This is the most expensive mixer when many inputs are active: every visible channel adds a full-frame blend. Prefer Mixer 4 or 8 when the extra channels are not needed. Mode can be changed in the module but cannot currently be CV-patched there.

Mix / Output

CV Split

Fans four independent CV inputs out to three identical destinations each.

Inputs

Label	Signal	Purpose
`In A`, `In B`, `In C`, `In D`	Float/CV	Four signals to duplicate. Unpatched inputs read as 0.

Outputs

Label	Signal	Purpose
`A1`, `A2`, `A3`	Float/CV	Three copies of In A.
`B1`, `B2`, `B3`	Float/CV	Three copies of In B.
`C1`, `C2`, `C3`	Float/CV	Three copies of In C.
`D1`, `D2`, `D3`	Float/CV	Three copies of In D.

Starting patch

Connect one LFO to In A, then route A1–A3 to three different effect parameters. Use each destination's range brackets to give the shared motion a different depth or direction.

Notes

CV Split copies values without scaling, smoothing, or delay and is computationally negligible.

Mix / Output

V-Split

Fans four independent video inputs out to three destinations each.

Inputs

Label	Signal	Purpose
`In A`, `In B`, `In C`, `In D`	Video	Four videos to duplicate.

Outputs

Label	Signal	Purpose
`A1`, `A2`, `A3`	Video	Three routes for In A.
`B1`, `B2`, `B3`	Video	Three routes for In B.
`C1`, `C2`, `C3`	Video	Three routes for In C.
`D1`, `D2`, `D3`	Video	Three routes for In D.

Starting patch

Connect one camera or generator to In A, then send A1 to a clean path, A2 through Feedback, and A3 through a color effect before recombining them.

Notes

V-Split routes the same video to each output without making extra copies or rendering new frames. An unpatched input produces no outputs in its group.

Mix / Output

Oscilloscope

Displays and passes through up to four CV signals so their motion can be inspected in the patch.

Inputs

Label	Signal	Purpose
`CV 1`, `CV 2`, `CV 3`, `CV 4`	Float/CV	Signals to display. Unpatched channels sit at 0.5.

Outputs

Label	Signal	Purpose
`Out 1`, `Out 2`, `Out 3`, `Out 4`	Float/CV	Live passthrough of the matching input.

Controls

Control	Initial value	Range / step or options	Purpose
`Zoom`	×1	×1–×8 / 1	Shows progressively newer portions of the 512-sample history.

Starting patch

Insert CV 1/Out 1 between an LFO and an effect, then raise Zoom to inspect a shorter section of the waveform. Add an audio envelope to CV 2 for comparison.

Notes

One sample per rendered frame is stored, so the visible time span depends on frame rate. The four outputs are not delayed by the display history. Oscilloscope is a monitor, not a video generator, and its UI refreshes independently from the graph's target frame rate.

Mix / Output

Output

Defines the patch's final picture, preview/display destinations, recording, canvas settings, mask, and output warp.

Inputs

Label	Signal	Purpose
`In`	Video	Final picture sent to preview, display, Syphon, NDI, and recording.
`Audio In`	Audio	Optional audio track for MOV recording.
`Global Opacity`	Float/CV	Fades the final picture.

Outputs

Label	Signal	Purpose
`TP Out`	Video	Patchframe's test-pattern video for setup or routing tests.

Controls

Control	Initial value	Range / step or options	Purpose
`PRV`	Closed	Closed, Open	Toggles the separate preview window.
`OUT`	Closed	Closed, Open	Toggles the borderless display-output window.
`REC`	Off	Off, On; save as `.mov`	Starts or stops recording after a save location is chosen.
`MASK`	None	PNG, JPEG, TIFF, GIF, HEIC; remove with ×	Uses luminance as an aspect-fill output mask: white is visible, black is hidden.
`Res` width × height	1920 × 1080	1–32,768 pixels / integer	Sets the patch canvas; this Beta build does not lock the resolution.
`FPS`	24	24, 25, 30, 60	Sets the target render and recording frame rate.
`Out` destination	No output	No display or any connected display; Syphon Off/On; NDI Off/On	Selects a display and optional sharing outputs.
`Global Opacity`	1	0–1 / 0.01	Final image opacity.
`Warp`	—	Button	Opens or closes the output mapping editor.
`Warp Enabled`	Off	Off, On	Activates corner pin and barrel correction.
Warp corners	Full frame	Four handles, each X/Y 0–1	Places the output corners.
`Barrel`	0	−1–1 / continuous	Applies pincushion through barrel distortion.
Warp `Reset`	—	Button	Restores full-frame corners and Barrel 0.

Starting patch

Connect a final mixer to In, open PRV, and confirm the canvas resolution/FPS. Choose a display only when ready; use TP Out to test another branch or mapping setup.

Notes

Output is offered in the picker only when the graph has no Output module; a normal patch should use one. Audio In affects recording only. Recording requires a writable save location and produces a QuickTime MOV; without Audio In it is video-only. Syphon requires a receiving macOS app. NDI requires the NDI runtime and network access; starting it can fail when the runtime is unavailable. A selected mask is remembered through macOS file access, so moving or deleting it prevents reload. Higher resolution/FPS and enabling display, sharing, warp, or recording increase GPU, memory, and transfer load.

Mix / Output

Partial Output

Places three independent videos into separately mapped regions of the full output canvas.

Inputs

Label	Signal	Purpose
`In A`, `In B`, `In C`	Video	Independent sources for circuits A, B, and C.

Outputs

Label	Signal	Purpose
`Out A`, `Out B`, `Out C`	Video	Full-canvas videos, transparent outside each mapped quad.

Controls

Control	Initial value	Range / step or options	Purpose
A/B/C `W`, `H`	Canvas width, height	Numeric pixels, displayed to 1-pixel precision; no explicit UI limit	Resizes that quad from its top-left corner.
A/B/C `Map`	Full canvas	Four corner handles, each X/Y 0–1	Opens the mapping editor for position, size, and skew.
Map `Grid`	Off	Off, On	Temporarily substitutes a test grid for that circuit's input.
Map `Reset`	—	Button	Restores that circuit to the full canvas.

Starting patch

Feed three sources into A–C, map each to a different screen region, then combine Out A–C with a Mixer before Output.

Notes

The three circuits remain separate; Partial Output does not composite them. Each output is always canvas-sized and corner-mapped, with no enable, mask, barrel, opacity, or CV controls. W/H values are text fields rather than bounded parameters, so use sensible positive sizes. Grid is session-only and turns off when its editor closes; the three mapped quads are saved with the patch. Each active circuit adds a full-canvas mapping pass.

Mix / Output

Group

Wraps modules into a collapsible instrument with shared video routing, eight macros, exposed jacks, and eight recallable macro scenes.

Inputs

Label	Signal	Purpose
`Tex In`	Video	Group-level video input; passes through unless routed to a child input.
`Macro 1`–`Macro 8`	Float/CV	Drive the eight group macros.
Exposed child inputs	Video, dynamic	Optional child video inputs added with Expose. Names follow the selected child jack.

Outputs

Label	Signal	Purpose
`Tex Out`	Video	Group passthrough or the selected child video output.
Exposed child outputs	Video or Float/CV, dynamic	Optional child outputs added with Expose. Names follow the selected child jack.

Controls

Control	Initial value	Range / step or options	Purpose
`Macro 1`–`Macro 8`	0.5	0–1 / 0.01	Drive any mapped child parameters.
Macro labels	1–8	Text, up to 12 characters	Double-click a label to rename it.
Expand/collapse	Collapsed	Collapsed, Expanded	Shows or hides child modules in the rack.
`Expose`	None	Unused child Video/Float outputs and child Video inputs	Adds selected child jacks to the group surface.
Exposed-jack menu	Visible	Hide from Group	Removes a surfaced jack without removing the child jack.
`Tex In` routing	Passthrough	Passthrough or any child Video input	Chooses where the group input is sent.
`Tex Out` routing	Passthrough	Passthrough or any child Video output	Chooses the group picture source.
Child parameter macro map	Unmapped	Macro 1–8, or Unmap	Available from a child parameter's menu while the group is expanded.
Mapping `Amt`, `Min`, `Max`	1, 0, 1	0–1 / continuous	Sets modulation depth and the target parameter range.
Scene 1–8	Empty	Store, Recall, Clear	Saves and recalls all eight macro values.
Lock Internals	Off	Off, On	Prevents expansion and dropping modules into the group.
Import default	Expanded	Expanded, Collapsed	Sets the preferred state when the group is imported.
Instrument Color	Palette Default	Palette Default, Color 1–6	Sets the group accent color.
Instrument Tags	None	Up to 8 unique lowercase tags, 16 characters each	Adds searchable library metadata.
Export Group	—	`.group` file	Saves the group and its children for reuse.
Ungroup	—	Action	Removes the container while keeping its child modules.

Starting patch

Select a small source/effect chain and choose Group. Expand it, map two child parameters to Macro 1, set their Amt/Min/Max ranges, route a child output to Tex Out, and store Scene 1.

Notes

A Group added directly from the picker starts empty; grouping a selection adopts those modules and attempts to establish useful primary video I/O. Surface ports change when jacks are exposed or hidden, so restored patches use saved port identities rather than a fixed schema. Expose currently supports child Video/Float outputs and child Video inputs; use macros for child parameter control. Locking internals collapses the group. Dense groups do not reduce the rendering cost of their children—they organize routing and performance controls rather than caching the result.