Libnotify

High level interface to libnotify API

Notification API

data Notification

Notification object

Instances

Eq Notification

Show Notification

display :: Mod Notification -> IO Notification

Display notification

>>> token <- display (summary "Greeting" <> body "Hello world!" <> icon "face-smile-big")

You can reuse notification tokens:

>>> display_ (reuse token <> body "Hey!")

display_ :: Mod Notification -> IO ()

Display and discard notification token

>>> display_ (summary "Greeting" <> body "Hello world!" <> icon "face-smile-big")

close :: Notification -> IO ()

Close notification

Modifiers

data Mod a

A notification modifier

Instances

Monoid (Mod a)

summary :: String -> Mod Notification

Set notification summary

>>> display_ (summary "Hello!")

body :: String -> Mod Notification

Set notification body

>>> display_ (body "Hello world!")

icon :: String -> Mod Notification

Set notification icon

>>> display_ (icon "face-smile")

The argument is either icon name or file name

timeout :: Timeout -> Mod Notification

Set notification timeout

data Timeout

Timeout after which notification is closed

Constructors

Default

Default server timeout

Custom Int

User defined timeout (in milliseconds)

Infinite

Notification will never expire

Instances

Eq Timeout

Data Timeout

Show Timeout

Typeable Timeout

Generic Timeout

category :: String -> Mod Notification

Set notification category

urgency :: Urgency -> Mod Notification

Set notification urgency

data Urgency

The urgency level of the notification

Constructors

Low

Low urgency. Used for unimportant notifications

Normal

Normal urgency. Used for most standard notifications

Critical

Critical urgency. Used for very important notifications

Instances

Eq Urgency

Data Urgency

Ord Urgency

Show Urgency

Typeable Urgency

Generic Urgency

image :: Pixbuf -> Mod Notification

Set notification image

class Hint v where

Add a hint to notification

It's perfectly OK to add multiple hints to a single notification

Methods

hint :: String -> v -> Mod Notification

Instances

Hint Double

Hint Int32

Hint Word8

Hint String

Hint ByteString

nohints :: Mod Notification

Remove all hints from the notification

action

Arguments

:: String

Name

-> String

Button label

-> (Notification -> String -> IO a)

Callback

-> Mod Notification

Add an action to notification

It's perfectly OK to add multiple actions to a single notification

>>> display_ (action "hello" "Hello world!" (\_ _ -> return ()))

noactions :: Mod Notification

Remove all actions from the notification

>>> let callback _ _ = return ()
>>> display_ (summary "No hello for you!" <> action "hello" "Hello world!" callback <> noactions)

reuse :: Notification -> Mod Notification

Reuse existing notification token, instead of creating a new one

If you try to reuse multiple tokens, the last one wins, e.g.

>>> foo <- display (body "foo")
>>> bar <- display (body "bar")
>>> display_ (base foo <> base bar)

will show only "bar"

Convenience re-exports

class Monoid a where

Methods

mempty :: a

mappend :: a -> a -> a

mconcat :: [a] -> a

Instances

Monoid Ordering

Monoid ()

Monoid ByteString

Monoid Any

Monoid All

Monoid [a]

Monoid a => Monoid (Maybe a)

Monoid (Endo a)

Monoid a => Monoid (Dual a)

Num a => Monoid (Sum a)

Num a => Monoid (Product a)

Monoid (Last a)

Monoid (First a)

Monoid (Mod a)

Monoid b => Monoid (a -> b)

(Monoid a, Monoid b) => Monoid (a, b)

(Monoid a, Monoid b, Monoid c) => Monoid (a, b, c)

(Monoid a, Monoid b, Monoid c, Monoid d) => Monoid (a, b, c, d)

(Monoid a, Monoid b, Monoid c, Monoid d, Monoid e) => Monoid (a, b, c, d, e)

(<>) :: Monoid m => m -> m -> m