bjarneo/quickshell

This repository is a personal collection of Quickshell configurations for Omarchy, written in QML. Quickshell is a tool for building parts of a Linux desktop, like the bar at the top of the screen and floating overlays, and Omarchy is a particular setup of the Hyprland window manager that ships its own color theme. These configs read Omarchy's live color palette from a TOML file, so whenever the user runs the omarchy theme set command, every overlay in this repo restyles itself to match. The repo is split into eight self-contained modules. The desktop module is the main one: a top bar combined with an omni-menu command palette that searches over installed apps and the omarchy menu, with synonyms so a query like wallpaper finds the background option and reboot finds restart. Two music modules, song-drop and song-slide, listen to MPRIS-capable players like mpv or Spotify and animate a notifier when the track changes, one as a liquid blob dropping from the bar, the other as a sliding card with an accent stripe and a progress bar. The theme-wash module plays a flourish whenever the theme changes, washing the new accent color across the bar. The remaining modules add small reactive touches. Music-wallpaper paints a pulsing visualizer on the background using an external feed from a program called cliamp. Clipboard-ripple shows a soft halo around the cursor each time something is copied. Battery-drip drips a teardrop down the edge of the bar when the battery crosses 20 percent or 10 percent, and fills a battery outline when the laptop is plugged in near full. Quickapps is a radial launcher of eight to ten favorite apps, meant to be bound to a Hyprland keybind for a Spotlight-style launch. To use them, you clone the repository into your Quickshell config directory and then start each overlay with qs and the module name, where qs is Quickshell's command-line tool. The README also lists supporting programs each module expects to be on the system, including pamixer, bluetoothctl, nmcli, brightnessctl, jq, curl, and wl-clipboard. The project is released under the MIT license.