Libnotify
Ruby bindings for libnotify using FFI.
Usage
Hash Syntax
require 'libnotify'
Libnotify.show(:body => "hello", :summary => "world", :timeout => 2.5)
Block Syntax
require 'libnotify'
n = Libnotify.new do |notify|
notify.summary = "hello"
notify.body = "world"
notify.timeout = 1.5 # 1.5 (s), 1000 (ms), "2", nil, false
notify.urgency = :critical # :low, :normal, :critical
notify.append = false # default true - append onto existing notification
notify.transient = true # default false - keep the notifications around after display
notify.icon_path = "/usr/share/icons/gnome/scalable/emblems/emblem-default.svg"
end
n.show!
Mixed Syntax
require 'libnotify'
# Mixed syntax
options = {:body => "world", :timeout => 20}
Libnotify.show(options) do |opts|
opts.timeout = 1.5 # overrides :timeout in options
end
Managing Icon Paths
require 'libnotify'
# Icon path auto-detection
Libnotify.icon_dirs << "/usr/share/icons/gnome/*/"
Libnotify.show(:icon_path => "emblem-default.png")
Libnotify.show(:icon_path => :"emblem-default")
Updating existing notification and closing it
# Update pre-existing notification then close it
n = Libnotify.new(:summary => "hello", :body => "world")
n.update # identical to show! if not shown before
Kernel.sleep 1
n.update(:body => "my love") do |notify|
notify.summary = "goodbye"
end
Kernel.sleep 1
n.close
Installation
gem install libnotify
You'll need libnotify. On Debian just type:
apt-get install libnotify1
Testing
git clone git://github.com/splattael/libnotify.git
cd libnotify
(gem install bundler)
bundle install
rake
Code coverage
COVERAGE=1 rake
Caveats
Ubuntu
timeout
and append
options might not work on Ubuntu.
See GH #21 for details.
#21 (comment)
Authors
- Peter Leitzen (https://github.com/splattael)
Contributors
- Dennis Collective (https://github.com/denniscollective)
- Daniel Mack (https://github.com/zonque)
- Nuisance of Cats (https://github.com/nuisanceofcats)
- Jason Staten (https://github.com/statianzo)
- Jeremy Lawler (https://github.com/jlawler)
- Kero van Gelder (https://github.com/keroami)
- René Föhring (https://github.com/rrrene)
- Cezary Baginski (https://github.com/e2)
- robisacommonusername (https://github.com/robisacommonusername)
- Fernando Briano (https://github.com/picandocodigo)
License
TODO
-
Unify show/update interface -> simplifies code
-
Turn FFI module into a class -> more plugabble
-
Support newer features of
libnotify
-> actions, hints? See https://developer-next.gnome.org/libnotify/0.7/NotifyNotification.html -
Support older versions of
libnotify
-> prior0.4
?