gled is an application for creating spatial animations on light installations.
Features
- All animations can be based on beat progression.
- Everything is hackable directly in gled:
- Animation shaders with a shader editor and preview
- Color palettes
- Scenes - a collection of animations
- Fixture definitions - the pixels of a lamp, drawn in gled
- The patch - fixtures placed, chained and addressed in a topology, with layouts for effects
- Support for multiple kind of output devices:
- Artnet
- DMX, currently the Enttec DMX USB Pro is supported
Installation
Download and install a Release.
Every merged merge request is released: a commit whose subject starts with feat raises the
minor version, one that mentions a breaking change the major version, anything else the patch
version.
Linux RPMs contain a yum.repos.d file so that gled is automatically updated with your system.
The Apple developer account for the signed Mac application is sponsored by FreshX GmbH.
Raspberry Pi 5
Each release also has an SD card image for a Raspberry Pi 5. It runs gled without a window as
gled-server, drives the Art-Net and DMX output and is controlled from browsers at
https://gled.local. The card becomes read-only after the first boot, so the Pi can be unplugged at
any time.
|
Before the first boot, edit network-config and user-data on the card's bootfs partition for the
network and an SSH login. The Raspberry Pi chapter of the documentation has the
details, including how to build the image yourself.
Documentation
The documentation is available at photonenkollektiv.gitlab.io/gled2.
OSC API (Work In Progress)
OSC input is received on UDP port 8000.
This implementation introduces hierarchical addresses for project and scene control.
Project and Timing
/osc/state/subscribe/osc/state/unsubscribe/project/main_dimmer <float>/project/blackout <bool|0|1>/project/palette <palette_uuid_string|none>/project/palette/primary <r> <g> <b>/project/palette/secondary <r> <g> <b>/project/palette/gradient/{gradient_index} <r> <g> <b>/project/artnet_control/active <bool|0|1>/project/artnet_control/universe <int>/project/input/tap/clear/project/input/tap/add/artnet <channel>/project/input/tap/remove/artnet <channel>/project/input/blackout/clear/project/input/blackout/add/artnet <channel>/project/input/blackout/remove/artnet <channel>/project/input/blackout_hold/clear/project/input/blackout_hold/add/artnet <channel>/project/input/blackout_hold/remove/artnet <channel>/project/input/half/clear/project/input/half/add/artnet <channel>/project/input/half/remove/artnet <channel>/project/input/double/clear/project/input/double/add/artnet <channel>/project/input/double/remove/artnet <channel>/timing/tap/timing/speed/add <float>/timing/speed/multiply <float>
Scene Selectors
- Grid selector:
/scene/grid/{col}/{row}/... - Quick-row selector:
/scene/quick/{index}/... - Selected scene alias:
/scene/selected/...
Grid uses 0 <= col < 8 and 0 <= row < 5.
Quick index uses 0 <= index < 8.
The selected-scene alias resolves against the currently selected scene when the command is handled.
Scene Commands
Supported for grid, quick, and selected selectors:
.../opacity <float>.../opacity/value <float>— set the multiplier only (preserves any selected curve).../opacity/static <float>— set a static value (replaces curve with multiplier-only).../opacity/curve <curve_uuid_string|none>— set or clear the curve (preserves the multiplier).../active <bool|0|1>.../toggle.../select.../name <string>.../color <red|green|blue|white|orange|yellow|purple|pink|black>.../input_dimmer <float>.../ignore_main_dimmer <bool|0|1>.../beat_offset <float>.../beat_offset/value <float>— set the multiplier only (preserves any selected curve).../beat_offset/static <float>— set a static value (replaces curve with multiplier-only).../beat_offset/curve <curve_uuid_string|none>— set or clear the curve (preserves the multiplier).../set_offset_on_flash <bool|0|1>.../activation_input/clear.../activation_input/artnet <channel>.../flash_input/clear.../flash_input/artnet <channel>.../dimmer_input/clear.../dimmer_input/artnet <channel>.../palette_overwrite <inherit|none|palette_uuid_string>.../palette_overwrite/primary <r> <g> <b>.../palette_overwrite/secondary <r> <g> <b>.../palette_overwrite/gradient/{gradient_index} <r> <g> <b>.../clone.../delete
Setting .../opacity also activates the targeted scene instance.
Setting .../opacity/value and .../opacity/curve do not activate the scene.
.../opacity/static behaves like .../opacity and activates the targeted scene instance.
Additional grid-only commands:
/scene/grid/{col}/{row}/add <scene_uuid_string>
Scene reorder command:
/scene/reorder/{from_col}/{from_row}/{to_col}/{to_row}
Effect Commands
Effect commands are available on grid, quick, and selected scene selectors.
Base effect path:
/scene/grid/{col}/{row}/effect/{effect_index}/.../scene/quick/{index}/effect/{effect_index}/.../scene/selected/effect/{effect_index}/...
Supported effect commands:
.../add(for/effect/addpath).../opacity <float>.../opacity/value <float>— set the multiplier only (preserves any selected curve).../opacity/static <float>— set a static value (replaces curve with multiplier-only).../opacity/curve <curve_uuid_string|none>— set or clear the curve (preserves the multiplier).../color_shift <float>.../color_shift/value <float>.../color_shift/static <float>.../color_shift/curve <curve_uuid_string|none>.../beat_progression <float>.../beat_progression/value <float>.../beat_progression/static <float>.../beat_progression/curve <curve_uuid_string|none>.../beat_offset <float>.../beat_offset/value <float>.../beat_offset/static <float>.../beat_offset/curve <curve_uuid_string|none>.../speed_exponent <int>.../layout <int>— the layout the effect renders on, by its index in the patch's layout stack:0is the topology,1,2, … the layouts in stack order,-1inherits the scene's layout. An index past the stack is ignored..../animation <animation_uuid_string|none>.../clone.../delete.../config/u32/{config_index} <int>.../config/f32/{config_index} <float>
Palette Behavior
Project palette selection copies the chosen palette asset into the project. Subsequent OSC palette color edits modify only the project-local palette state and do not mutate the source palette asset.
Scene palette overwrite selection also copies palette asset data into the scene instance override. Direct scene palette overwrite color edits create or replace the scene-local override palette and do not touch the source asset.
OSC feedback synchronization is only active for clients that explicitly subscribe.
/osc/state/subscribe and /osc/state/unsubscribe use the UDP source address/port of the client message as feedback destination.
For scene feedback, subscribed clients receive the same field families on /scene/grid/{col}/{row}/... and /scene/quick/{index}/... as on /scene/selected/... for overlapping scene/effect state (input_dimmer, ignore_main_dimmer, beat_offset, set_offset_on_flash, effect/count, and effect parameter fields).
An effect's .../layout feedback is the stack index it takes (-1 while it inherits), so a client can send it back unchanged.
The layout stack is reported to subscribed clients as:
/project/layouts/count <int>— the number of layouts, the topology included/project/layouts/{index} <name>— each layout by its stack index,0the topology
Animation Asset Editing
Animation asset shader and argument edits by UUID:
/asset/animation/{animation_uuid}/shader_code <string>/asset/animation/{animation_uuid}/argument/add/asset/animation/{animation_uuid}/argument/{argument_index}/remove/asset/animation/{animation_uuid}/argument/{argument_index}/name <string>/asset/animation/{animation_uuid}/argument/{argument_index}/kind <center|selection|slider|checkbox|percentage|degrees>
Tests
crates/gled-core/src/input/osc/samples.rs holds at least one message for every address above;
add one there for each new address. A unit test checks that all of them parse. A second test
sends all of them to the real engine with a copy of a local asset repository and fails if the
engine reports an error or stops. It needs a GPU, so it is ignored by default: