Skip to content

Widgets properties

All widgets share a set of generic properties described below.



  • type: string
  • default: fader


  • type: string
  • default: generated unique 'widget_n'
  • usage: widgets sharing the same id will act as clones and update each other's value(s) without sending extra osc messages.


  • type: string
  • default: empty
  • usage: widgets sharing the same linkId update each other's value(s) AND send their respective osc messages.



  • type: string|false
  • default: auto, which displays id
  • usage:
    • set to false to hide completely
    • insert icons from FontAwesome using the prefix ^ followed by the icon's name : made with ^heart, etc

topflash_on / leftflash_on

  • type: number|percentage
  • default: auto
  • usage:
    • when both top and left are set to auto, the widget is positioned according to the normal flow of the page (from left to right, by order of creation).
    • otherwise, the widget will be absolutely positioned

widthflash_on / heightflash_on

  • type: number|percentage
  • default: auto


  • type: string
  • default: auto, inherited accent color
  • usage: any valid css color code is valid, this will change the default accent color for the widget and all its children


  • type: string
  • default: empty
  • usage: the css property can be used to override inherited theming variables. Also, some widgets expose specific theming variables that allow a finer customization. Standard css properties can be applied to the widget's root element through this property, css selectors can also be used apply custom styles to the widget's children.
  • examples:
    • border-radius:5rem; .label {font-size: 20rem} will round the widget's corners and increase its label's font-size and all its children's labels'
    • border-radius:5rem; > .label {font-size: 20rem} will round the widget's corners and increase its label's font-size (the > selector targets only the direct children of the widget element)

& { }

The & selector can be used to target the widget container.



  • type: *
  • default: empty
  • usage: if set, the widget will be initialized with this value when the session is loaded. Some widgets use this property under specific conditions (see fader's doubleTap for example).


  • type: *
  • default: empty
  • usage: set value to define a widget's value depending on other widget's values / properties using property inheritance and property maths. When updated by an osc-sending event (e.g. dragging a slider), the widget will send its own osc message as well.

default and value must match the widget's value type (ie a number for sliders, an array for pads, etc) and restrictions (equal to on or off for a push/toggle button)



  • type: integer|string
  • default: 2
  • usage: the precision property defines the number of decimals to display and to send.
  • set to 0 to send integers only.
  • a specific data type can be specified by appending a valid osc type tag to the precision value, for example : 3d will make the widget send double precision numbers rounded to three decimals


  • type: array
  • default: []
  • usage:
    • this defines the targets of the widget's osc messages
    • each element of the array must be a string formatted as follows : "ip:port"
    • multiple targets can be specified : ["ip1:port1","ip2:port2"]
    • if midi is enabled, targets can be "midi:device_name"
    • special item "self" can be used to refer to the emitting client directly
    • if no target is set (empty array []), messages can still be sent if the server has defaults targets (-s / --send)
    • to disable osc regardless of the previous point, set target to [null]


  • type: string
  • default: /widgets_id
  • usage: this is the address of the osc messages sent by the widget, it must start with a /


  • type: string
  • default: empty
  • usage: sliders and pads can send special osc messages to inform weither they are currently touched or not. The osc message will be of the following form :
        /touch/address [preArgs] 0/1


  • type: array
  • default: []
  • usage:
    • each element of the array defines a constant value that will be prepended to the osc message
    • values can be defined as objects if the osc data type needs to be specified (ie different from the default implied by the precision option)
  • example:
    preArgs: [
        "1",        // this will always be sent as a string
        0.5,        // this will be sent as an integer if precision equals 0
        1,          // this will be sent as float if precision is different from 0


  • type: boolean
  • default: false
  • usage: set to true to prevent the widget from sending any osc message