Gnome Notification
| Schemes | gnome:// |
| Cargo feature | service-gnome |
| Service | https://www.gnome.org/ |
| Body formats | text (first is the default) |
| Attachments | no |
| Title length | no title (merged into the body) |
| Body length | 32,768 characters |
| Body lines | 10 lines |
| Request throttle | none |
| Vendor URLs accepted | no |
URL formats
{schema}://
{schema} is one of gnome://.
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
image | Include Image | bool | yes | |
urgency | Urgency | choice | 1 | also priority; one of 0, 1, 2 |
The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.
Examples
Accepted URLs (tokens are fake):
gnome://
gnome://_/
gnome://?image=yes
gnome://?urgency=2
gnome://_/?image=False
gnome://?priority=low
gnome://_/?priority=invalid
gnome://_/?image=no&urgency=high
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'gnome://'
Notes
GNOME (gnome://): desktop notifications as libnotify sends them.
Mercurio connects to the session bus itself (DBUS_SESSION_BUS_ADDRESS, else $XDG_RUNTIME_DIR/bus; unix:path= and Linux unix:abstract= addresses), authenticates with EXTERNAL and calls Notify the way libnotify’s Notification.new(body) does: app id, replaces-id 0, the icon file (empty with ?image=no), the body as the summary (the title is merged into it), no body, no actions, {urgency: byte} and the daemon’s default timeout (-1).
Differences with Apprise
- Apprise uses libnotify bindings, while mercurio speaks D-Bus itself.
- libnotify also sends a
sender-pidhint and the icon asimage-datapixels, while mercurio passes the icon file asapp_icon.