Skip to content
Noctalia Noctalia
FAQ

Shell & UI

These commands open, close, or toggle Noctalia UI surfaces.

General

Section titled “General”
ActionCommandDescription
Print statusnoctalia msg statusPrint basic shell state as JSON.
Reload confignoctalia msg config-reloadReload config files immediately.
Toggle settingsnoctalia msg settings-toggleOpen or close the graphical settings window.

Bar

Section titled “Bar”
ActionCommandDescription
Show barnoctalia msg bar-showShow the bar.
Hide barnoctalia msg bar-hideHide the bar.
Toggle barnoctalia msg bar-toggleToggle bar visibility.

Scripted widgets

Section titled “Scripted widgets”
ActionCommandDescription
Send eventnoctalia msg scripted-widget <widget-name> <target[:bar-name]> <event> [payload]Dispatch an event to a scripted bar widget. Target can be focused, all, a monitor selector such as DP-1, or a bar-qualified target such as focused:default.

Panels

Section titled “Panels”
ActionCommandDescription
Toggle launchernoctalia msg panel-toggle launcherOpen or close the app launcher.
Toggle session menunoctalia msg panel-toggle sessionOpen or close the logout, reboot, and shutdown menu.
Toggle clipboardnoctalia msg panel-toggle clipboardOpen or close clipboard history.
Toggle wallpaper panelnoctalia msg panel-toggle wallpaperOpen or close wallpaper picker.
Toggle control centernoctalia msg panel-toggle control-centerOpen or close Control Center.

Wallpaper

Section titled “Wallpaper”
ActionCommandDescription
Random wallpaper nownoctalia msg wallpaper-randomSwitch to a random wallpaper immediately.

Dock

Section titled “Dock”
ActionCommandDescription
Show docknoctalia msg dock-showShow all dock instances and save that override.
Hide docknoctalia msg dock-hideHide all dock instances and save that override.
Toggle docknoctalia msg dock-toggleToggle dock visibility and save the new state.
Reload docknoctalia msg dock-reloadReload dock configuration.

Desktop widgets

Section titled “Desktop widgets”
ActionCommandDescription
Enter edit modenoctalia msg desktop-widgets-editStart moving, resizing, rotating, and removing desktop widgets.
Exit edit modenoctalia msg desktop-widgets-exitLeave desktop widget edit mode.
Toggle edit modenoctalia msg desktop-widgets-toggle-editSwitch edit mode on or off.

Notifications

Section titled “Notifications”
ActionCommandDescription
Enable Do Not Disturbnoctalia msg notification-dnd-set onHide notification toasts. Notification history still fills.
Disable Do Not Disturbnoctalia msg notification-dnd-set offShow notification toasts again.
Toggle Do Not Disturbnoctalia msg notification-dnd-toggleToggle notification toast visibility. Notification history still fills.
Show Do Not Disturb statusnoctalia msg notification-dnd-statusPrint the current Do Not Disturb state.
Clear active notificationsnoctalia msg notification-clear-activeDismiss all currently visible active notifications.
Clear notification historynoctalia msg notification-clear-historyRemove all entries from notification history.

Media

Section titled “Media”
ActionCommandDescription
Previous tracknoctalia msg media previousAsk the active MPRIS player to go to the previous item.
Play/pause togglenoctalia msg media toggleToggle play/pause on the active MPRIS player.
Next tracknoctalia msg media nextAsk the active MPRIS player to go to the next item.

Theme

Section titled “Theme”
ActionCommandDescription
Toggle theme modenoctalia msg theme-mode-toggleSwitch between dark and light theme mode.

Session

Section titled “Session”
ActionCommandDescription
Lock sessionnoctalia msg screen-lockLock the current session.