Greeter Plugin

The Greeter plugin provides login screen functionality for Waxed-based systems. It’s designed as a lightweight, trimmed-down desktop experience with just enough functionality to display an animated background and provide the UI needed for user authentication.

Visual Experience

Displays animated backgrounds (video loops, shader effects, or slideshows), smooth transitions and subtle animations, customizable themes that match the desktop aesthetic, and multi-monitor support with synchronized visuals.

Authentication

Handles username/password entry via PAM, support for multiple user accounts, remembers the last logged-in user, and keyboard navigation for accessibility.

Integration

Works with the Transitioner plugin. On system boot, Waxed loads the Transitioner, which in turn loads the Greeter as the initial plugin. Once authentication succeeds, the Transitioner handles the smooth handoff to the full desktop plugin.

Design Philosophy

The Greeter intentionally shares architecture with the LEF Desktop plugin but strips away everything non-essential. No panels, no window management, no system tray. Just a beautiful animated background and the minimal UI required to get someone logged in. This shared lineage means visual consistency between the login experience and the desktop itself.