Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

DEPRICATED: use ruby_gntp instead: Growl gem for ruby based on the applescript api

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 spec
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .rspec
Octocat-spinner-32 Gemfile
Octocat-spinner-32 Guardfile
Octocat-spinner-32 LICENSE.txt
Octocat-spinner-32 Rakefile
Octocat-spinner-32 Readme.md
Octocat-spinner-32 growl_notify.gemspec
Readme.md

GrowlNotify

This gem is based on the rb-appscript bindings to applescript

Benefits over all other growl gems:

  1. The user doesn't need to do anything but install the gem - no growl settings need to be changed and growlnotify cli doesn't need to be installed
  2. Thats about it

Usage

Configuring

GrowlNotify.config do |config|
  config.notifications = ["Compass Application", "Someother Notification"]
  config.default_notifications = ["Compass Application"] 
  config.application_name = "My Application" #this shows up in the growl applications list in systems settings
end

You can also set a globally scoped icon:

GrowlNotify.config do |config|
  config.notifications = ["Compass Application", "Someother Notification"]
  config.default_notifications = ["Compass Application"] 
  config.application_name = "My Application" #this shoes up in the growl applications list in systems settings
  config.icon = File.join("SOME PATH")
end

Using

Notification levels:

  1. very_low: GrowlNotify.very_low(:title => 'HELLO WORLD', :description => 'Man that was cool')
  2. moderate: GrowlNotify.moderate(:title => 'HELLO WORLD', :description => 'Man that was cool')
  3. normal: GrowlNotify.normal(:title => 'HELLO WORLD', :description => 'Man that was cool')
  4. high: GrowlNotify.high(:title => 'HELLO WORLD', :description => 'Man that was cool')
  5. emergency: GrowlNotify.emergency(:title => 'HELLO WORLD', :description => 'Man that was cool')

Sticky messages

GrowlNotify.sticky!(:title => 'HELLO WORLD', :description => 'Man that was cool')

Options

{:title => 'no title', :application_name => "My Application", :description => 'no description', :sticky => false, :priority => 0, :with_name => "Compass Application", :icon => <file path>}
  1. title - Title of message box
  2. description - Body of your message
  3. icon - Icon to show - pretty much all image formats are supported
  4. priority - importance of message from -2 very_low .. 2 emergency
  5. sticky - boolean if want the message to stick to the screen
  6. application_name - This is set from configs but you can override it
  7. with_name - must me one of your set default notifications by default its set to the first one

Error Handling

If the growl application is not installed on the system GrowlNotify will throw a GrowlNotFound exception.

Author

GrowlNotify is written by Scott Davis

Scott is a Developer for the Space Telescope Science Institute in Baltimore, MD - Hubble Space Telescope

Twitter

Copyright

Copyright (c) 2011 Scott Davis. See LICENSE.txt for further details.

Something went wrong with that request. Please try again.