Flexible toolkit for making desktop shells with QtQuick, for Wayland and X11
2.6k
Stars
157
Forks
368
Open issues
30
Contributors
AI Analysis
Quickshell is a flexible toolkit for building custom desktop shells and widgets on Linux using QtQuick, supporting both Wayland and X11. It is purpose-built for users and developers who need to create bespoke desktop environments and system bars rather than use pre-built desktop shells, making it particularly valuable for tiling window manager users, power users, and developers extending Linux desktops. General desktop users seeking a ready-made environment are not its target audience.
Inferred from signals mentioned in the README (tests, CI, type safety) — not a review of the actual code.
AI's overall editorial judgment — not an average of the bars above, can weigh other factors too.
QtQuick-based desktop shell toolkit for Wayland/X11, 2.6k stars, 15 months old, actively maintained
Quickshell is a C++ framework for building custom desktop shells and panels using QtQuick (QML), supporting both Wayland and X11. It targets users who want to create bespoke desktop environments without building from scratch. Created March 2024, it has accumulated 2,620 stars and shows steady activity. The project appears aimed at power users and developers rather than mainstream desktop adoption.
Quickshell emerged in March 2024 as a toolkit for procedural desktop shell development. The ecosystem already contained QML-based shell projects (DankMaterialShell, caelestia-dots/shell), suggesting growing interest in QML-driven desktop environments. Quickshell positions itself as a structured toolkit rather than a pre-built shell.
The project gained approximately 2,620 stars over 15 months (≈175 stars/month average). Recent activity shows 23 stars in the last 7 days and continuous git activity through June 30, 2026. Growth appears steady but modest compared to established competitors (7k–10k star projects in similar space). The growth curve suggests a stable niche audience rather than exponential adoption.
Adoption not verified. README does not cite production deployments, organizations using Quickshell, or deployment case studies. The existence of similar competitor projects with significantly higher star counts (7k–10k) may indicate Quickshell users are not consolidating into this single codebase, or adoption is concentrated among developers who customize rather than users of pre-built shells.
Based on README, Quickshell appears to be a C++ framework wrapping QtQuick for Wayland/X11 interoperability. The project separates concerns into development (HACKING.md), contribution (CONTRIBUTING.md), and build (BUILD.md) documentation, suggesting modular design. Specific architectural details are not detailed in the README excerpt provided.
Not documented in README excerpt.
Last push June 30, 2026 (3 days before evaluation date) indicates active maintenance. Repository includes formal contribution and development policies (CONTRIBUTING.md, HACKING.md, BUILD.md), suggesting structured project governance. LGPL-3.0 license is clearly stated. Dual hosting (git.outfoxxed.me + GitHub mirror) suggests intentional infrastructure choices. Maintenance appears active and deliberate.
ADOPT IF: you are building a custom Wayland/X11 shell and prefer QtQuick + C++, value formal project governance (CONTRIBUTING.md, HACKING.md), and can tolerate a small ecosystem. AVOID IF: you need production-grade maturity signals, extensive community examples, or guaranteed long-term support from a large organization. MONITOR IF: you are considering QML for desktop development and want to track whether Quickshell's toolkit approach gains traction relative to pre-built shell projects.
Independent dimensions
Mainstream potential
3/10
Technical importance
6/10
Adoption evidence
2/10
- Adoption not verified in public sources; may indicate limited real-world deployment or users who don't disclose usage.
- Smaller star count than established competitors (7k–10k) suggests ecosystem fragmentation or barrier to mainstream adoption.
- Project is 15 months old; long-term stability and API compatibility guarantees unknown.
- Limited README detail on architecture, testing, and deployment best practices; users may face learning curve.
- Dual-hosted repository (git.outfoxxed.me + GitHub mirror) could complicate contribution workflows or community discovery.
Quickshell likely remains a specialist toolkit for developers building custom Wayland/X11 shells over the next 1–2 years. Mainstream adoption appears unlikely absent significant organizational backing or major ecosystem consolidation. Project will probably maintain steady, slow growth within the QML/desktop customization niche.
Newsletter
Get analyses like this every Monday
Free weekly digest of the most interesting open-source discoveries.
Languages
Information
- Website
- https://quickshell.org
- Language
- C++
- License
- LGPL-3.0
- Last updated
- 2d ago
- Created
- 29mo ago
- Analyzed with
- anthropic/claude-haiku-4-5
Stars over time
Contributors over time
Top 100 contributors only — repos with more will plateau at 100.
Open issues
IpcHandler fails to register within WlSessionLock context
quickshell crashes on startup
StatusNotifierItem use-after-free crash when tray item is unregistered
crashed
Crash when opening Apple Music in Firefox
Top contributors
Recent releases
Similar repos
AvengeMedia/DankMaterialShell
DankMaterialShell is a complete desktop shell for Wayland compositors (niri,...
noctalia-dev/noctalia
Noctalia is a native Wayland desktop shell that consolidates typical fragmented...
stdware/qwindowkit
QWindowKit is a cross-platform frameless window customization framework for Qt...
caelestia-dots/shell
Caelestia-shell is a desktop shell for Linux built with QML and Quickshell that...
| Repository | Stars | Week Δ | Language | Score | Updated |
|---|---|---|---|---|---|
|
quickshell-mirror/quickshell
this
|
2.6k | +26 | C++ | 7/10 | 2d ago |
|
AvengeMedia/DankMaterialShell
|
7.2k | — | QML | 8/10 | 13h ago |
|
noctalia-dev/noctalia
|
8.5k | — | C++ | 7/10 | 20h ago |
|
stdware/qwindowkit
|
1.1k | — | C++ | 7/10 | 6d ago |
|
caelestia-dots/shell
|
10.4k | — | QML | 7/10 | 5d ago |
 qt/qt5
|
1.8k | — | Shell | 8/10 | 1d ago |
Higher adoption signal. Both QML-based but DankMaterialShell appears to be a complete shell distribution rather than a toolkit for building shells, likely explains adoption gap.
Significantly higher stars. Also QML-based; Quickshell's toolkit approach is more programmatic, caelestia-dots/shell may be more approachable for dotfile users.
Similar language (C++) but higher star count. Comparison quality unknown without inspecting both repositories; both serve desktop shell niches.
Lower adoption. Smaller Qt/C++ ecosystem component; Quickshell's broader shell-building focus may attract wider interest than windowing utilities.
Higher adoption but likely serves NixOS-specific configuration rather than cross-platform shell development; different use case.