back to home

xarbit / plasma6-applet-appgrid

A modern application launcher for KDE Plasma, inspired by macOS and COSMIC.

84 stars
3 forks
5 issues
QMLC++Shell

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing xarbit/plasma6-applet-appgrid in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Source files are only loaded when you start an analysis to optimize performance.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind.in/repo/xarbit/plasma6-applet-appgrid)
Preview:Analyzed by RepoMind

Repository Overview (README excerpt)

Crawler view

AppGrid A modern application launcher for KDE Plasma, inspired by macOS Launchpad, COSMIC, and Pantheon. AppGrid ships as two plasmoids that share a common codebase: • **AppGrid** — a standalone window launcher with its own blur, opacity, and corner radius settings. • **AppGrid (Panel)** — a native Plasma panel popup that opens anchored to the panel icon, just like Kickoff. For those who prefer the traditional style. Both variants share the same app grid, search, categories, quick commands, and configuration — pick whichever fits your workflow. Requires version 1.2+. > **Note:** Starting with the 1.5.x release, AppGrid is considered feature complete. The focus going forward will be on stability, polish, and community-requested improvements. AppGrid is still a young project and may contain bugs or not work as expected on all setups. A big thank you to everyone who has been testing, reporting issues, and providing feedback — it has been invaluable in shaping the project. If you run into any issues, please open an issue and report back. > **Compatibility:** AppGrid targets KDE Plasma 6 and supports a wide range of distributions. Multi-monitor screen selection works best with LayerShellQt 6.6+, but falls back to the older API on earlier versions. Pre-built packages are provided for Arch Linux (AUR), Fedora, openSUSE Tumbleweed, Ubuntu 25.04+, and Debian 13+. Why AppGrid? KDE Plasma ships with Kickoff and Kicker as its default application launchers. While they are feature-rich, I find them difficult to navigate and slower to use for everyday app launching. I've always preferred the simplicity of how COSMIC, macOS Launchpad, and Pantheon handle application launching — a clean grid where everything is visible at a glance. Since nothing like that existed for Plasma, I decided to build one that fits my workflow. Screenshots Features • **Two plasmoid variants** — standalone window launcher, or a native Plasma panel popup (like Kickoff) • Favorites tab — right-click any app to add it, with optional start-on-favorites mode and reorderable positions • Category filtering with scrollable category bar, mouse wheel support, and Alt+key mnemonic navigation • Option to hide the category bar for a minimal look • **Two category modes** — simplified built-in categories for a clean look, or system categories that respect KDE Menu Editor changes • KDE Menu Editor integration — right-click categories to edit them (system categories mode) • **Unified search** — app results and KRunner results (windows, bookmarks, calculator, web search, etc.) merged into a single seamless list with continuous Tab/arrow navigation and Alt+1–9 shortcuts • Duplicate filtering — apps already shown in app results are automatically hidden from KRunner results • Application actions (jumplist) — right-click any app to see its actions (e.g., Firefox → New Private Window) • Quick commands — terminal, shell commands, file browser (type for help) • Configurable terminal shell for quick commands ( , , , etc.) • Sort by most used or alphabetically • New app detection with badge • Configurable icon hover animations — shake, grow, bounce, spin, shuffle, or none • Session management (sleep, restart, shut down, lock, log out) • Context menu with add to favorites, pin to Task Manager, add to Desktop, hide apps • Customizable grid size, icon size, background blur, opacity, and corner radius • Multi-monitor support — configurable to open on active screen (mouse focus) or panel screen • Reset to defaults button for easy configuration recovery • Drop-in replacement via Plasma's Show Alternatives Dependencies Runtime • plasma-workspace • kservice • ki18n • kio • krunner • layer-shell-qt Build • cmake • extra-cmake-modules • qt6-base • qt6-declarative • libplasma • kpackage • kio • kcoreaddons • krunner • kwindowsystem • layer-shell-qt • gettext Installation Pre-built packages Pre-built packages for Fedora, openSUSE, Ubuntu, and Debian are available on the Releases page. These are auto-generated and provided as is — I'm not a packager, and they may not follow all distro packaging standards. Ideally, distribution maintainers would pick up AppGrid for their official repositories. If you're a packager and want to maintain AppGrid for your distro, please reach out so I can link to your package and eventually retire these from the CI pipeline. Arch Linux (AUR) — officially supported The AUR package is maintained by the author and is the only officially supported package at this time. Building from source After installing, restart Plasma: Usage • Right-click your current application launcher in the panel • Select **Show Alternatives** • Choose **AppGrid** Or add it as a new widget: right-click the panel → **Add Widgets** → search for **AppGrid**. There are two variants: • **AppGrid** — opens as a standalone window • **AppGrid (Panel)** — opens as a native Plasma popup anchored to the panel icon, like Kickoff Keyboard shortcuts | Key | Action | |-----|--------| | Super | Toggle AppGrid | | Escape | Close | | Enter | Launch top search result | | Alt+1–9 | Launch numbered search result (apps and KRunner results) | | Alt+letter | Jump to category by mnemonic | | Arrow keys | Navigate results | | Tab | Cycle through search results (apps + KRunner unified) | | Type anywhere | Start searching | Configuration Right-click the AppGrid panel icon → **Configure AppGrid** → **General**. | Setting | Description | Default | |---------|-------------|---------| | **Icon** | Panel icon or custom image | | | **Icons per row** | Number of columns in the grid | 7 | | **Visible rows** | Number of rows visible before scrolling | 4 | | **Icon size** | Small, medium, or large | Large | | **Sort order** | **Alphabetical** sorts apps A–Z. **Most Used** sorts by launch frequency, so your most opened apps appear first. | Most Used | | **Show category bar** | Show or hide the category filter bar. When hidden, all apps are shown. | On | | **Search all apps** | Sea…