Auragen docs
Auragen docs

Getting Started

OverviewInterfaceNode GraphParameters and Controls

Operators

Generators
Custom GLSL
3D PreviewperformMODE
GeneratorsCustom

Custom GLSL

A generator node that runs your own fragment shader, with declared uniforms auto-exposed as animatable sliders.

The Custom GLSL node runs a fragment shader you write directly in the node's parameter panel. Any uniform you declare becomes a slider, so a few lines of GLSL produce a fully controllable, animatable generator.

Custom GLSL demo shader output

  • One texture output; a texture input, plus texture and audio inputs you add, readable from the shader; a composite input
  • A code editor with live compile, Shadertoy conversion, and ISF support
  • Found in the node graph under Generators in the add-node menu
Example patch — drag onto the app to load

The image on the right is the example patch itself — drag and drop it onto the app (or load it with File → Load) to open the full graph. It contains the ring shader shown above, with two custom uniforms (rings, glow) exposed as sliders.

Inputs and outputs

Custom GLSL node

PortTypePurpose
Texture inTextureAvailable inside the shader as uTexture (or iChannel0 in Shadertoy-style code)
Texture in 2, 3 …TextureAdded with + Texture in. Available inside the shader as uTexture2, uTexture3 … (iChannel1 to iChannel3). One with nothing wired reads Texture in
Composite InputTextureComposited under the output with Composite Mode and Composite Mix, which appear once the port is wired
Audio in 1, 2 …ModifierAdded with + Audio in. Wire a Sound node (or any modifier) in; the shader reads the value as audio_In1, audio_In2 …. Reads 0 with nothing wired
OutputTextureWhatever your shader writes to gl_FragColor

Adding inputs

The node starts with one texture input. The Inputs group in the node's parameters adds more:

  • + Texture in adds a texture input, up to 8 in all
  • + Audio in adds an audio input
  • The × next to an added input removes it, with its wire

Each input keeps its number when another one is removed, so the shader keeps reading the same input.

To make your own audio uniform, click + Audio in, set a Sound node to the frequency range and response you want, wire it into Audio in 1, and read audio_In1 in the shader. #define kick audio_In1 gives it a name.

Parameters

Custom GLSL parameters with the shader editor

Opacity, Blend Mode, ALPHA — the standard operator header.

  • GLSL Code — the shader source, edited in the panel's code editor. With Auto checked the shader recompiles as you type; otherwise click Compile. Compile errors appear below the editor with a line number.
  • ISF — a source that starts with an ISF (Interactive Shader Format) JSON header is compiled as ISF: the header's INPUTS become parameters with their declared types, ranges, and defaults.
  • Shader Parameters — every uniform float, int, bool, vec2, vec3, or vec4 you declare is auto-detected and listed here as a control. Sliders get the standard per-parameter animation bar, so custom uniforms can be animated, audio-driven, or MIDI-mapped like any built-in parameter — see Parameters and Controls.
  • Audio — appears once the shader names an audio uniform such as audio_BassLevel; selects the audio source, from the same list a Sound node offers. A Sound node wired into one of the node's Audio in inputs sets the source instead: the dropdown grays out and names that input. Show spectrum displays the live spectrum of the source in use. See Audio uniforms.

Built-in uniforms available in every shader: uTime (float, animation time), uResolution (vec2, pixels), uMouse (vec2, normalized), uTexture (sampler2D, the Texture in input), uTexture2 and up (sampler2D, the added Texture in inputs), and the pointer uniforms _mouse, _click, _muv, _muvc. Shadertoy conventions (iTime, iResolution, mainImage(...)) are converted automatically on compile.

For the full shader-writing reference — built-in uniforms per format, uniform annotations, audio uniforms, and loading SSF scenes (.synScene) — see Custom GLSL Shaders.

Troubleshooting

Node renders black after loading a patch or preset — if the stored code has a compile error, the node stays black and shows an error badge; select it and read the message in its parameters. Valid code compiles automatically on first evaluation, no click required.

A texture wired into Texture in 2 does nothing — the shader has to read it: sample uTexture2 (or iChannel1 in Shadertoy-style code).

My uniform slider has a useless range — a bare declaration gets a default range. Add // @range <min> <max> on the same line as the uniform, or in an ISF shader declare MIN/MAX in the header.

particleDRAW

A brush that paints particles — draw on the viewport and each stroke emits sprites that live, move, and fade on their own.

Texture

Every Texture operator — loaders, compositing, transforms, colour, displacement, and conversion — in one reference.

On this page

Inputs and outputsAdding inputsParametersTroubleshooting