About this project

wlapse is a stopwatch overlay designed for Wayland-based Linux desktop environments. It can be toggled on and off with a keybind, making it convenient for quick timing tasks without requiring a daemon or autostart. Key features include: - Toggle on/off with a keybind - No daemon or autostart required - Draggable with left mouse button - Remembers position between runs - Custom background and text colors - Compatible with Sway, Hyprland, Niri, and KDE Plasma Requirements: - Linux with an active Wayland session - A compositor supporting wlr-layer-shell and relative-pointer-v1 - Rust 1.98+ and Cargo for building from source Installation options include AUR package for Arch Linux, AppImage, release binaries, or building from source with Cargo. Usage involves binding the wlapse command to a key combination in your compositor's configuration. The tool also supports command-line invocation for testing. Configuration is done via a config file at $XDG_CONFIG_HOME/wlapse/config, allowing customization of background and text colors using #RRGGBB or #RRGGBBAA formats. The overlay can be moved by dragging with the left mouse button, and the position is saved automatically. To reset the position, delete the placement file from $XDG_STATE_HOME/wlapse/. wlapse is licensed under the MIT License.