CLI

CLI (noticenterctl)

noticenterctl talks to the UnixNotis control plane over D-Bus.

Common usage

# Open and close the panel
noticenterctl open-panel
noticenterctl close-panel

# Toggle DND
noticenterctl dnd toggle

# Clear all notifications
noticenterctl clear

Workspace usage:

cargo run --release -p noticenterctl -- open-panel

Commands

• toggle-panel
• open-panel [--debug <level>] where level is critical|warn|info|verbose
• close-panel
• dnd <on|off|toggle>
• clear
• dismiss <id>
• list-active [--full]
• list-history [--full]
• inhibit <reason> [--scope <all|popups>]
• uninhibit <id>
• list-inhibitors
• css-check

Debug logging

open-panel --debug enables panel debug logging for the current session:

UNIXNOTIS_DIAGNOSTIC=1 noticenterctl open-panel --debug verbose

Listing notifications

The --full flag emits summaries and bodies when diagnostic mode is enabled:

UNIXNOTIS_DIAGNOSTIC=1 noticenterctl list-active --full

Inhibit examples

# Suppress popups while a fullscreen app is running
TOKEN=$(noticenterctl inhibit "presentation" --scope popups)

# Later, re-enable popups
noticenterctl uninhibit "$TOKEN"

# Inspect current inhibitors
noticenterctl list-inhibitors

CSS validation

css-check scans $XDG_CONFIG_HOME/unixnotis (or $HOME/.config/unixnotis when XDG is unset), skipping backup directories, and reports CSS parse errors plus override warnings (duplicate selectors/properties, including inside @media, @supports, @layer, @container, and @document blocks).

noticenterctl css-check

Related

• D-Bus API reference: D-Bus-API