[Xfce4-commits] [apps/xfce4-notifyd] 01/01: Update README to reflect panel plugin
noreply at xfce.org
noreply at xfce.org
Sun Sep 10 01:49:17 CEST 2017
This is an automated email from the git hooks/post-receive script.
o c h o s i p u s h e d a c o m m i t t o b r a n c h m a s t e r
in repository apps/xfce4-notifyd.
commit 91d43d53167721130df7be4a530c6657bdd3c216
Author: Simon Steinbeiss <simon.steinbeiss at elfenbeinturm.at>
Date: Sun Sep 10 01:48:36 2017 +0200
Update README to reflect panel plugin
---
README | 49 +++++++++++++++++++++++++++----------------------
1 file changed, 27 insertions(+), 22 deletions(-)
diff --git a/README b/README
index b805a17..6ef200f 100644
--- a/README
+++ b/README
@@ -1,13 +1,16 @@
Xfce Notify Daemon
==================
-The Xfce Notify Daemon (xfce4-notifyd for short) is a smallish program that
-implements the "server-side" portion of the Freedesktop desktop notifications
-specification. Applications that wish to pop up a notification bubble in
-a standard way can implicitly make use of xfce4-notifyd to do so by
-sending standard messages over D-Bus using the org.freedesktop.Notifications
+The Xfce Notify Daemon (or "xfce4-notifyd") is a small program that implements
+the "server-side" portion of the Freedesktop desktop notifications
+specification. Applications that wish to pop up a notification bubble in a
+standard way can implicitly make use of xfce4-notifyd to do so by sending
+standard messages over D-Bus using the org.freedesktop.Notifications
interface.
+Apart from the notification server a panel plugin is included which shows recent
+notifications in a dropdown menu in the Xfce Panel.
+
Requirements:
-------------
@@ -18,11 +21,10 @@ Requirements:
* libxfce4ui 4.12.0
* xfconf 4.10
* libnotify 0.7
+* libxfce4panel 4.12.0 (for the panel plugin)
-Additionally, having a compositing manager running is recommended; in that
-case xfce4-notifyd will optionally look a bit nicer and will be
-semi-transparent and will fade out, and other nice pretty things.
-This isn't required by any means, of course.
+Additionally, having a compositing manager running is recommended. This is
+necessary for features like transparency and animations.
Installation:
@@ -30,12 +32,12 @@ Installation:
The usual:
- ./configure
+ ./autogen.sh
make
make install
should work just fine. Pass --prefix=/path/to/wherever to install in a
-location other than /usr/local.
+location other than the default /usr/local.
In order for xfce4-notifyd to be started automatically, you must have a
<servicedir> directive in your D-Bus session configuration file. If you
@@ -46,22 +48,25 @@ to worry about this.
Configuration:
--------------
-Run xfce4-notifyd-config to display the settings dialog. There aren't any
-other tunables; if you don't see it in the settings dialog, it's not
+Run xfce4-notifyd-config to display the settings dialog. There are no hidden
+settings, which means if you don't see it in the settings dialog, it's not
changeable.
+The panel plugin has a separate properties dialog, which shows all configuration
+options for it.
+
Theming:
--------
Xfce4-notifyd uses Gtk+'s standard theming system. By default it will use the
"app-notification" or "osd" classes of your Gtk+ theme. If you want to override
-the default notifications style of your theme by referencing the
-"#XfceNotifyWindow" widget name or you can either create a separate standalone
-theme (see the examples provided, e.g. "ZOMG-PONIES!").
-You'll want to put your gtk css file in $HOME/.themes/THEMENAME/xfce4-notify-4.0
-and then start up the configuration dialog to set the theme. If you think
-you've come up with a cool theme, feel free to send it to me, and I'll be happy
-to include it in the next release. For themes shipped with xfce4-notifyd, I
-require all parts of them to be redistributable under the terms of a license
-compatible with the GPLv2.
+the default notifications style of your theme you can use the
+"#XfceNotifyWindow" widget name or you can create a standalone theme (see the
+examples included, e.g. "ZOMG-PONIES!").
+You have to put your gtk.css file in $HOME/.themes/THEMENAME/xfce4-notify-4.0
+and then start up the configuration dialog to set the theme.
+
+If you have created a cool theme you can submit it via a bugreport on
+bugs.xfce.org. For themes shipped with xfce4-notifyd, all parts are required to
+be redistributable under the terms of a license compatible with GPLv2.
--
To stop receiving notification emails like this one, please contact
the administrator of this repository.
More information about the Xfce4-commits
mailing list