Skip to main content
otter-notifications implements org.freedesktop.Notifications on D-Bus. Apps using notify-send or the standard notification API work without changes.

Usage

otter-notifications
Autostart at login: see Session setup.

Sending notifications

# Basic
notify-send "Hello" "World"

# Critical (persistent by default)
notify-send -u critical "Alert" "Something important"

# Low urgency
notify-send -u low "FYI" "Not urgent"

# With icon
notify-send -i firefox "Browser" "Download complete"

Configuration

Config file: ~/.config/otter-shell/notifications.conf Fallback: /etc/otter-shell/notifications.conf
FieldDefaultDescription
positiontop_rightScreen position (top/bottom × left/center/right)
max_visible5Max on screen (overflow queued)
width360Notification width in pixels
default_timeout10000Normal urgency timeout (ms)
low_timeout4000Low urgency timeout (ms)
critical_timeout0Critical timeout (0 = persistent)
gap8Vertical gap between notifications
icon_size48Icon size in pixels
Colors inherit from theme.conf when not set.

Interaction

  • Left click: Dismiss and activate the source application
  • Right click: Dismiss without activating
Config and theme hot-reload via inotify.