Arch Linux

Package	Description
`veila-bin`	Pre-compiled binary (recommended)
`veila-git`	Builds 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

Start the daemon

veilad

Or better run it as a user service with systemd:

systemctl --user enable --now veilad.service

Lock directly from the CLI:

veila lock

Example keybind for Hyprland:

bind = SUPER, Escape, exec, veila lock

The AUR packages install a dedicated PAM service at /etc/pam.d/veila using Arch's shared system-auth stack, plus the veila(1) man page for CLI reference.

That is enough to get started. It works out of the box, and no extra configuration is required for a basic setup.

You do not need to go through the full configuration reference just to make small changes. For simple tweaks like changing the wallpaper, avatar, clock or date format, or a few widget options, start with the default theme or pick another theme you like and follow the instructions on that theme page.