Ubuntu Manpages

feedback-themes

Theme configuration for feedbackd

The feedback provided to the user for an event is determined by the currently active feedback theme.

Each theme consists of up to three profile sections named full, quiet and silent containing event names and their associated feedback. They can reference another theme via the parent-name element to avoid repetition. If an event received by the daemon is not present in the currently active theme or its parent theme it will be ignored.

Each event maps to at most one feedback in each profile. The events in the theme are named according to the Event Naming Specifiaction <https://gitlab.freedesktop.org/agx/feedbackd/-/blob/main/doc/Event-naming-spec-0.0.0.md>.

There are two types of themes: custom themes and device themes. They both use the same format but have different purpose. Custom themes are meant to tweak feebackd's output to the user's needs while device themes are meant to cater for hardware differences. Feedback themes use a JSON format that can be validated with fbd-theme-validate(1).

For details on how to create or modify feedback themes see feedbackd's documentation at <https://gitlab.freedesktop.org/agx/feedbackd#feedback-theme>.

To build a theme you can use several different feedback types:

  • Sound: Plays a sound from the installed sound theme
  • VibraRumble: A single rumble using the haptic motor
  • VibraPeriodic: A periodic rumble using the haptic motor
  • VibraPattern: A pattern specifying the rumbling of the haptic motor
  • Led: A LED blinking in a periodic pattern

Sound feedbacks specify an event name from a XDG sound theme. Sound themes are described in the Sound theme spec at <https://freedesktop.org/wiki/Specifications/sound-theme-spec/>

  • event-name: The sound event name to use.
  • media-role: The media role to set played audio stream. Defaults to event.

Sound feedback is usually used in the full profile section of the theme only.

The VibraRumble feedback uses a single property

  • count: The number of rumbles.
  • pause: The pause between each rumble in ms.
  • duration: The duration of the rumble in ms.
  • mangitude: The relative magnitude of the rumble ([0, 1]).

VibraRumble feedback is usually used in the quiet profile section of the theme only.

The VibraPattern feedback has these properties

  • magnitudes: The relative magnitude of each rumble [0, 1] as array of doubles.
  • durations: The durations of each rumble in ms as array of unsigned integers.

Both arrays must have the same length. VibraPattern feedback is usually used in the quiet profile section of the the theme only.

The Led feedback type uses two properties to specify the way a LED blinks.

  • color: This specifies the color a LED should blink with. It supports the fixed color names red, green, blue and white as well as values in the RGB HEX format (#RRGGBB) where RR, GG and BB are two digit hex value between 00 and FF specifying the value of each component. E.g. #00FFFF corresponds to cyan color.
  • frequency: The LEDs blinkinig frequency in mHz.

Led feedback is usually used in the silent profile section of the theme only.

feedbackd(8) fbcli(1) fbd-theme-validate(1)