Skip to content

toast-preset ​

A reusable toast preset, triggerable by id with lys-shell toast --preset <id>.

A preset captures a toast's text and icon so it can be fired by name. The label/icon can still be overridden per invocation, and runtime-only fields (--percentage, --duration, --class) are supplied at invoke time, not stored on the preset. Duration always follows the OSD config.

Example ​

yaml
osd: {presets: [{id: saved, label: Saved, icon: ld-check-symbolic}]}

# Fire it: lys-shell toast --preset saved
# With a progress bar: lys-shell toast --preset saved --percentage 80

General ​

FieldTypeDefaultDescription
idstringrequiredUnique identifier. Trigger with lys-shell toast --preset <id>.
labelunknownnullToast text. An explicit label on the command line overrides this.
iconunknownnullSymbolic icon name shown beside the text.

Default configuration ​

Required fields (must be set in your config): id.

Released under the MIT License.