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.

The Power Menu is a full-screen overlay that gives you quick access to system power actions. It appears as a semi-transparent backdrop covering the entire desktop, with a centred card displaying four options. A confirmation step prevents accidental actions: you must confirm your choice before the shell executes the command. You can dismiss the menu at any point by pressing Escape or clicking anywhere outside the card.

Available actions

ActionWhat it does
ShutdownPowers off the system immediately after confirmation.
RebootRestarts the system after confirmation.
SuspendSuspends the system to RAM (sleep mode).
LogoutEnds the current Hyprland session.

How to open the power menu

1

From the LeftBar

Click the Power icon at the bottom of the LeftBar icon strip. Unlike other LeftBar icons, this one does not open the side panel — it emits the TOGGLE_POWER_MENU event directly, which makes the PowerMenuWindow visible.
2

From a keyboard shortcut

Bind the power menu to a key in your Hyprland config using the Quickshell IPC interface:
bindd = $mainMod, l, Power options, exec, quickshell ipc call LeftBar togglePowerMenu

Confirmation step

After selecting an action, the power menu displays a confirmation dialog asking you to verify your choice. This prevents a mis-click from triggering an irreversible action. Click Confirm to proceed or Cancel to return to the option list.
Shutdown and Reboot are irreversible. Make sure you have saved all open work before confirming either of these actions.

Closing the menu

You can exit the power menu without taking any action in three ways:
  • Press Escape.
  • Click anywhere on the semi-transparent backdrop outside the card.
  • Click Cancel in the confirmation dialog.
The PowerMenuWindow is created as a single global instance in shell.qml and its visibility is toggled by the TOGGLE_POWER_MENU event from EventBus. It is not tied to a specific monitor, so the overlay always appears on the focused screen.

Build docs developers (and LLMs) love