Interface Control

Interface Control modules let patches interact with Usine itself: open dialogs, load workspaces, control the grid, access master settings, manage presets, read setup values, and debug with the trace panel. They are the bridge between your patch logic and the Usine application.

Categories

Category Modules Description
Dialogs 8 Confirmation, file open/save, folder selection, input box, message box, and instant notifications
Load 3 Dynamically load patches, racks, or workspaces
Grid 5 Control and monitor the main grid and custom grid modules
Master & Mixer 3 Master panel settings, light panel, and VU-meters
Patch, Rack & Workspace 4 Access settings for the current patch, rack, and workspace
Presets 2 Preset panel and preset settings management
Setup 4 Access Usine setup panel and read setup values (data, string, color)
Trace & Debug 5 Print data, strings, and MIDI to the trace panel, progress bar display
System Info 5 Engine info, language ID, object access by address, hidden string trigger, and translation
Interface Panels 3 Interface Builder, toolbox, and trash panel settings
MIDI & OSC Events 2 Trigger on incoming MIDI or OSC messages

Dialogs

Open standard OS dialogs and display notifications from within a patch.

Module Description
Dialog Confirmation Yes No Yes/No confirmation dialog
Dialog Confirmation Yes No Cancel Yes/No/Cancel confirmation dialog
Dialog File Open Standard file open dialog with filter and root folder
Dialog File Save Standard file save dialog with filter and default extension
Dialog Folder Open Folder selection dialog
Dialog Input Box Text input dialog with prompt and caption
Dialog Message Box Simple message dialog with OK button
Dialog Instant Message Brief notification in the upper-right corner (auto-dismisses after 3 seconds)

Load

Dynamically load patches, racks, or entire workspaces from a file path.

Module Description
Load Patch Load a patch into a specified rack and position
Load Rack Load a rack into the workspace at a specified index
Load Workspace Load an entire workspace (with optional confirmation prompt)

Grid

Control the main grid or add custom grids for show sequencing, section navigation, and fade management.

Module Description
Usine Grid Module Independent custom grid panel with full transport, section navigation, speed, and fade controls
Usine Main Grid Settings Access main grid transport: on/off, section navigation, speed, playlist chaining
Usine Main Grid Section Settings Get current section info: index, caption, cursor position, color
Usine Main Grid Fade Value Get current grid fade value and fade state (none, in, out, stop)
Usine Main Grid Active Elements List List active grid elements with line numbers, fade states, and coefficients

Master & Mixer

Access the master panel, light panel, and audio VU-meters.

Module Description
Usine Master Settings Full master panel replica: volume, on/off, panic, learn, lock, save, panels, CPU/memory monitoring
Usine Master Light Settings Light panel controls: plot display and light panic
Usine Master Vu Meters All master VU-meter values (input and output) in decibel, linear, or RMS scale

Patch, Rack & Workspace

Read and modify settings of the current patch, rack, or workspace.

Module Description
Usine Patch Settings Patch controls: randomize, reset, edit, minimize/reduce, preset recall, fade duration
Usine Rack Settings Rack controls: gain in/out, mute, solo, on/off, caption, color, VU-meters, presets
Usine Workspace Settings Workspace info: rack count, visible racks, filename, time control, thumbnail
Usine Setup Settings Show/hide the full setup panel

Presets

Manage presets programmatically: store, recall, save/load to file.

Module Description
Usine Preset Module Full preset panel: store, recall, previous/next, save/load to file, target scope (patch, rack, workspace)
Usine Preset Settings Get/set preset info: current number, fade duration, scope, preset names list

Setup

Read values from Usine's setup configuration files.

Module Description
Usine Setup Value DATA Read a data (float) value from setup files
Usine Setup Value String Read a string value from setup files
Usine Setup Value Color Read a color value from setup files

Trace & Debug

Print values to the trace panel for debugging and display progress bars.

Module Description
Usine Trace Data Print data values to the trace panel (continuous or on-change)
Usine Trace String Print string values to the trace panel
Usine Trace MIDI Print MIDI messages to the trace panel
Usine Trace Settings Access trace panel settings and commands
Usine Progress Bar Display text and gauge in Usine's progress bar (auto-hides after 3 seconds or at 100%)

System Info

Access Usine engine information, object values, language, and translations.

Module Description
Usine Global Informations Gets engine state as JSON: CPU, memory, IP, status, workspace, grid info
Usine Language ID Get the current Usine language (en, fr, de, etc.)
Usine Object Get Retrieve any object's value by its remote address
Usine Hidden String Fire a trigger when a specific string is typed on the keyboard (Easter eggs, secret controls)
Usine Translator String Translate an identifier using Usine's language files

Interface Panels

Control Interface Builder, toolbox, and trash panels.

Module Description
Usine IB Settings Access Interface Builder panel settings and commands
Usine Toolbox Settings Toolbox panel: show, hide, toggle fullscreen
Usine Trash Settings Trash panel replica with configurable icon shape

MIDI & OSC Events

Detect incoming MIDI or OSC messages globally.

Module Description
Usine On MIDI Receive Fire a trigger when any MIDI message is received on any device
Usine On OSC Receive Fire a trigger when any OSC message is received on any port

See also

version 7.0.250121

Edit All Pages