About this project

TopBar is an interactive bar and desktop environment built for Quickshell, targeting Wayland compositors such as Hyprland and Mango. It provides a collection of desktop shell components aimed at users who want a customizable, widget-driven environment. Features include responsive widgets, a dashboard, an application launcher, a notification system, a preferences panel, a logout panel, a lock screen, wallpaper management, on-screen display (OSD), and power mode controls. The project also exposes an IPC interface, allowing users to trigger actions such as showing the bar via commands like `quickshell -c topbar ipc call show`. Requirements include a Wayland compositor, Quickshell, Nerd fonts, Qt6, CMake, and Ninja. Installation follows a standard CMake build flow, and the bar is launched with `quickshell -c topbar`. The README notes a common troubleshooting step: if the config directory cannot be found, users should ensure `XDG_DATA_DIRS` is set appropriately. Contributions are accepted via Codeberg or e-mail.