> ## Documentation Index
> Fetch the complete documentation index at: https://docs.otter-shell.org/llms.txt
> Use this file to discover all available pages before exploring further.

# otter-notifications

> Wayland notification daemon for anything that uses freedesktop Notifications over D-Bus.

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

## Usage

```bash theme={null}
otter-notifications
```

Autostart at login: see [Session setup](/desktop/session-setup).

## Sending notifications

```bash theme={null}
# 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`

| Field              | Default     | Description                                      |
| ------------------ | ----------- | ------------------------------------------------ |
| `position`         | `top_right` | Screen position (top/bottom × left/center/right) |
| `max_visible`      | `5`         | Max on screen (overflow queued)                  |
| `width`            | `360`       | Notification width in pixels                     |
| `default_timeout`  | `10000`     | Normal urgency timeout (ms)                      |
| `low_timeout`      | `4000`      | Low urgency timeout (ms)                         |
| `critical_timeout` | `0`         | Critical timeout (0 = persistent)                |
| `gap`              | `8`         | Vertical gap between notifications               |
| `icon_size`        | `48`        | Icon size in pixels                              |

Colors inherit from [theme.conf](/configuration/themes) when not set.

## Interaction

* **Left click**: Dismiss and activate the source application
* **Right click**: Dismiss without activating

Config and theme hot-reload via inotify.