phosphor-shell-launcher

Spotlight-style launcher over apps, windows, clipboard, arithmetic, and commands.

Two targets in one directory. The PhosphorShellLauncher C++ core links without any UI: a port of fzf's default scorer in FuzzyMatcher, a Desktop Entry parser and scanner, the ranked LauncherModel, and five built-in providers implementing PhosphorRegistry::ILauncherProvider. A provider is a pure data source: it takes the query, reports when its results change, and performs a row's primary or alternate action. ClipboardProvider and WindowsProvider are duck-typed over their source models, so the core does not link the clipboard service or the Wayland stack. The Phosphor.Launcher QML module draws the surface: a search field, a provider filter that Tab cycles, a result list with a sliding selection line, and a placement-map miniature of the current screen on which window results are drawn over their cells. All keyboard handling runs from the search field, so focus never leaves it.

Full API →

Key types

LauncherModel
Every provider's rows for the query, ranked within a provider and filterable to one.
FuzzyMatcher
fzf-compatible fuzzy scorer, with a perfect score for exact-answer providers.
DesktopEntryScanner
Walks the applications directories, first match wins per desktop-file id.
AppsProvider
Installed applications, rescanned when an applications directory changes.
CommandProvider
Runs the typed line through /bin/sh -c when its first word resolves on PATH.
Launcher
QML surface: query field, provider filter, result rows, and the placement-map miniature.

Dependencies

See also

References