sandsmark/reddit-notifier

This is a KDE plasmoid that shows reddit notifications
from the RSS feed of notifications from your reddit account.

It sits in the panel, and pops up if there is a new notification.
Clicking on a notification will open the relevant reddit page
in user's default browser.
Fun-fact: Clicking on the title in the plasmoid will take you
straight to reddit.com in your browser!

=INSTALL=========

Make sure you are running the KDE SC version >= 4.8.
You would also require the 'zip' package installed.
(Test by simply running the 'zip' command on console)

Make and install the plasmoid package from source:

$ cd reddit-notifier-kde-plasmoid/
$ sh install.sh

The plasmoid is now installed and can now be added to the desktop/panel
from the widgets list.

The source directory can also be safely deleted.

=USAGE==========

After the plasmoid is added, go to "Reddit Notifier Settings" by right-clicking
on the plasmoid, and enter your reddit account's RSS feed URL for
notifications. To get the feed URL, open your reddit account in a browser, go
to preferences, RSS feeds, and get the URL of the feed you want. Paste the URL
in plasmoid's settings box and click OK. This is a one-time procedure (whenever
you add the plasmoid) and the notifications will be synced on your desktop with
an interval of one minute.

=AUTHORS=========

Name: Martin Sandsmark
Email: martin.sandsmark@kde.org

Original author:
Name: Viranch Mehta
Email: viranch.mehta@gmail.com

=LICENSE========

The following license applies to all of the content residing in the
directory that contains this README:

Copyright (C) 2012 by Viranch Mehta <viranch.mehta@gmail.com>
Copyright (C) 2012 by Martin Sandsmark <martin.sandsmark@kde.org>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU Library General Public License as
published by the Free Software Foundation; either version 2, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Library General Public License for more details

You should have received a copy of the GNU Library General Public
License along with this program; if not, write to the
Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.