Sweets
Configuration

Startup Programs

Start programs once when a Sweets session becomes ready.

Use sweets.exec_once(command) to start a program once for each Sweets session:

sweets.exec_once("waybar")
sweets.exec_once("veila")
sweets.exec_once("awww-daemon")

Each argument is a non-empty shell command. Commands run in the order written, after Sweets has opened its Wayland socket and initialized IPC. They inherit WAYLAND_DISPLAY, SWEETS_SOCKET, and variables configured with sweets.env(...).

exec_once commands run at compositor startup only. Saving or reloading sweets.lua changes the commands for the next Sweets session but does not launch, stop, or restart any programs in the current one.

When using the systemd-managed Sweets session, it also starts standard XDG desktop autostart entries. Configure a program in one place only: either its .desktop autostart entry or sweets.exec_once(...). Otherwise it can start twice.