Launcher

The Noctalia launcher is a centralized search interface that provides quick access to your applications, system actions, and utility providers.

How search works

Section titled “How search works”

As you type, Noctalia queries all active Launcher Providers. Providers can either be “global” (always searching) or “prefixed” (triggered by a specific keyword).

Global providers (like Applications and Calculator) results are merged and sorted by a relevance score.
Prefixed providers (like Emoji and Wallpaper) take over the search results when their prefix is detected at the start of your query.

Type / by itself to show a lightweight overview of available prefixed providers. Activating one inserts its prefix into the launcher input.

Usage-based boosting

Section titled “Usage-based boosting”

The launcher tracks how often you activate specific results (applications and wallpapers). Frequently used items receive a score boost, surfacing them at the top of the results list even with partial queries.

Section titled “Category filters”

When category filters are enabled, the launcher shows compact filter buttons for providers that expose categories.

Applications can be filtered by desktop-entry categories such as Internet, Development, Games, Office, System, and Utilities.
Emoji can be filtered by emoji categories such as people, animals, food, travel, objects, symbols, and flags.
All leaves the active result set unfiltered.

Press F6 while the launcher is open to reveal hidden filters without changing the active filter. Once the filters are visible, use F6 to move to the next filter and Shift+F6 to move to the previous filter.

Providers

Section titled “Providers”

Applications

Section titled “Applications”

The primary provider for finding and launching your installed apps.

When shell.launcher.app_grid is enabled and every visible result is an application, results switch from the default list to a multi-column icon grid with the app name underneath. Mixed searches (calculator hits, emoji, session actions, prefixed providers, and so on) keep the list layout. Left/right keybinds move between columns in grid mode; up/down move by row.

Source : Reads .desktop entries from standard XDG directories (e.g., /usr/share/applications, ~/.local/share/applications).
Search : Matches against the application name, generic name, keywords, and categories.
Scoring : Uses fuzzy matching with weights. Activation count boosts the score.

Calculator

Section titled “Calculator”

A built-in expression evaluator powered by libqalculate.

Prefix : None (Global).
Trigger : Automatically activates when the query contains a digit and evaluates to a result.
Functionality : Standard arithmetic and functions (sin, cos, sqrt, pi, e, …), plus unit conversion (10 cm to in, 100 km/h to mph), number bases (0xff), and currency conversion (10 USD to EUR). Pressing Enter copies the result to your clipboard.
Currency rates : Exchange rates are cached locally and refreshed in the background from libqalculate’s ECB/global providers. Refresh is skipped when [shell].offline_mode is enabled, in which case the last cached rates are used.

Emoji

Section titled “Emoji”

A quick way to find and copy emojis.

Prefix : /emo
Functionality : Searches emoji.json by name, category, and keywords. Activating a result copies the emoji character directly to your clipboard.

Example: /emo heart

Wallpaper

Section titled “Wallpaper”

Quickly browse and apply wallpapers from your configured directories.

Prefix : /wall
Source : Searches the directories defined in your [wallpaper] config.
Functionality : Filters by filename and parent directory name. Activating a result immediately applies the wallpaper to all monitors and updates your theme if using wallpaper as the theme source.
Scoring : Activation count boosts the score.

Session

Section titled “Session”

Run enabled session menu actions from the launcher.

Prefix : /session
Source : Uses the configured shell.session.actions entries, including custom labels, icons, and commands.
Functionality : Activating a result runs the same action path as the session panel, including logout, suspend, reboot, shutdown, lock, custom command entries, and configured hooks.

Windows

Section titled “Windows”

Find and focus any currently open window.

Prefix : /win
Source : Lists the windows reported by your compositor across every monitor and workspace.
Functionality : Fuzzy-matches against the window title and app id. Activating a result focuses the window, switching to its workspace if needed.

Dmenu mode

Section titled “Dmenu mode”

noctalia dmenu is a stdin/stdout picker for scripts that already produce newline-separated choices:

Terminal window

printf 'alpha\nbeta\ngamma\n' | noctalia dmenu -p "Pick"

It opens the launcher scoped to those candidates, prints the selected line to stdout, and exits 0. Closing the launcher or pressing Escape prints nothing and exits 1. -p / --prompt sets the launcher input placeholder for that picker. A tab inside a candidate splits the display into title and description, but the full original line is still returned. If the current filter has no candidate match, pressing Enter returns the typed text.

The command talks to the running Noctalia instance on the same XDG_RUNTIME_DIR and WAYLAND_DISPLAY; start Noctalia first, then call noctalia dmenu from scripts or compositor commands.

Configuration

Section titled “Configuration”

The launcher itself is mostly automatic, but its behavior is influenced by other sections of your config:

Keybinds: Customize navigation (up, down) and activation (validate, cancel).
Shell: ui_scale and font_family affect the launcher’s appearance. shell.launcher.categories controls the category filters. show_icons, compact, app_grid, and sort_by_usage adjust result layout and ordering (Settings → Panels → Launcher). [shell.launcher.dmenu.entry.<id>] adds custom dmenu-style providers backed by a shell command.
Wallpaper: Defines the search paths for the Wallpaper provider.
Session actions: Defines the actions shown by the Session provider.