Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AhmedSaadi0/NibrasShell/llms.txt

Use this file to discover all available pages before exploring further.

NibrasShell gives you two ways to search for and launch applications. The first is the in-panel launcher inside the LeftWindow, accessible by clicking the All Apps icon at the bottom of the LeftBar. The second is the Bottom Launcher — an optional full-width overlay that rises from the bottom of the screen and provides a larger, more keyboard-friendly search experience. Both launchers share the same search engine and support special commands prefixed with >.

​
In-panel launcher

By default, clicking All Apps in the LeftBar opens the app launcher inside the LeftWindow side panel alongside the other sections (Dashboard, Notifications, etc.). You can browse categories or type to filter applications instantly.

​
Bottom Launcher

The Bottom Launcher is an alternative that replaces the in-panel view with a floating overlay anchored to the bottom of the screen. Enable it in your config: 
{
  "useBottomLauncher": true,
  "bottomLauncherWidth": 700
}
Config keyTypeDescription
useBottomLauncherboolWhen true, the All Apps button opens the bottom overlay instead of the side panel.
bottomLauncherWidthintWidth of the bottom launcher overlay in pixels.
When useBottomLauncher is true, the BottomLauncher panel is toggled via the TOGGLE_BOTTOM_LAUNCHER event. You can also trigger it from a Hyprland keybinding using the toggleBottomLauncher IPC function.

​
Keyboard shortcut

Bind the app launcher to a key in your Hyprland config using the Quickshell IPC pattern from binding.conf: 
bindd = $mainMod, r, Show application launcher, exec, quickshell ipc call LeftBar toggleApplauncherMenu

​
Special commands

Type > at the start of your query to run a built-in command instead of searching apps:
CommandAction
> settingsOpens the NibrasShell Settings App.
> nextSwitches to the next wallpaper in the current rotation.
> prevSwitches to the previous wallpaper.
> wallpapersOpens the wallpaper picker interface.
The > prefix is inspired by VS Code’s command palette. You can type partial command names — the launcher filters and shows matching commands as you type.

​
Enabling and disabling via Settings App

You can also toggle between the in-panel and bottom launcher without editing config files directly. Open the Settings App (via > settings or the Dashboard panel), navigate to the App Launcher section, and switch the Use bottom launcher toggle. The change takes effect immediately without restarting the shell.

Build docs developers (and LLMs) love

Get started for freeTalk to us