NotifySend for Ruby
This gem allows you to generate desktop notifications from your Ruby script.
It replicates the functionality of notify-send
, but actually bypasses it completely and goes direct to dbus
.
Installation
gem install ruby-notify-send
Usage
require 'notify-send'
# With positional parameters:
NotifySend.send "Long running process just completed"
NotifySend.send "Title", "some extra text"
NotifySend.send "Title", "some extra text", "error" # <--- specifiying an icon
# With a hash:
NotifySend.send({summary: "Hi", timeout: 2000})
NotifySend.send({summary: "Hi", body: "Hello, World!", icon: "info"})
Icons
The :icon
parameter can be one of:
- 'error', 'info'
- Any of the files in
/usr/share/notify-osd/icons/gnome/scalable/status
, minus the file extension (if you're on Ubuntu) - An absolute path to an image file, e.g.
{icon: "/home/user_name/Desktop/some_image.jpg", summary: ...}
Notes and known issues
:timeout
seems to be ignored on my desktop- If
:summary
is an empty string, the notification will not be displayed