Skip to Content
Veila
Installation

Arch Linux

Install from the AUR with either the prebuilt package or the latest git build.

PackageDescription
veila-binPre-compiled binary (recommended)
veila-gitBuilds from the latest main branch

Install from the AUR:

# pre-compiled binary (recommended)
yay -S veila-bin

# or build from source via AUR
yay -S veila-git

Lock without a service:

veila lock

Stays in the foreground until unlock.

For keybinds or external idle tools:

veila lock --daemonize --wait-ready

For example, in Hyprland:

bind = SUPER, Escape, exec, veila lock --daemonize --wait-ready

Optional: start the idle/sleep watcher:

systemctl --user enable --now veila.service

Or start veila idle from your compositor. Run one watcher per display. For sweetidle, swayidle, and sleep hooks, see Lock control.

AUR packages include /etc/pam.d/veila using Arch’s system-auth stack, plus the veila(1) man page.

No config is required. Customize the default theme or choose another theme.