quickshell-mirror/quickshell

Health v2 · maintenance only

Adoption not part of the score

2873 stars · 184 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Quickshell is a toolkit for building desktop shell components such as status bars, widgets, lockscreens, and display managers using QtQuick and QML. It provides integrations for Wayland and X11 windowing, Hyprland/i3/Sway workspaces, Pipewire audio, Bluetooth, system tray, and more, with hot reloading of configuration changes.

Use cases

• build a custom wayland status bar
• create desktop widgets for linux
• make a lockscreen with pam authentication
• build a display manager with greetd
• customize my hyprland desktop shell
• replace waybar with a programmable bar
• build a system tray and audio mixer widget

When to choose

• you want to program your own desktop shell components rather than tweak a prebuilt bar
• you need deep integrations like Pipewire, BlueZ, MPRIS, or StatusNotifierItem in a custom shell
• you want hot reloading while iterating on QML configurations
• you use Hyprland, i3, or Sway and want workspace-aware widgets

When to avoid

• you just want a simple preconfigured status bar like Waybar without programming
• you need a fully preconfigured desktop environment out of the box
• you are not willing to learn QML, since configuring Quickshell is essentially programming
• you need a stable 1.0 API, as breaking changes are still expected before 1.0

Facets

framework · maturity active

ui-components gui developer-tools audio-processing auth desktop-applications operating-systems developer-tools cross-platform cpp qtquick qml wayland x11 status-bar desktop-shell widgets lockscreen pipewire system-tray hot-reload hyprland sway i3 linux desktop

Member repositories

For agents

markdown · JSON · MCP: product_card(name="quickshell-mirror/quickshell")