/reddit_monitor

Little Python app that puts an icon in your system tray and tells you when you have new messages

Primary LanguagePython

--INTRO---
Hello and welcome to my little app I wrote that puts
an icon in your system tray and tells you when you
have new messages on Reddit. It's pretty simple and
straight forward. Here is an example of what it looks
like:

http://github.com/PhillipTaylor/reddit_monitor/raw/a0ad84b5fb93590be7e2324d7e789ee02952009e/Demo.png


--REQUIREMENTS--
The requirements for this application are:
-	Systems that use GTK
-	Python 2.x



--DOWNLOADING--
To get the program you can either download the
source code using the "download" button above or you
can use the git link. There are no binaries and no
need for them.

--INSTALLATION AND SETUP--
There is nothing to compile and it runs from your
home directory.


--USAGE--

There are basically two python files. One does the work of
communicating with reddit and one does the GTK sys tray stuff.

./reddit.py <USERNAME>

tells you the karma and comment karma of a user, e.g.

[phill@phillfed reddit_monitor]$ ./reddit.py philluminati
User philluminati has 94 karma and 6013 comment karma

[phill@phillfed reddit_monitor]$ ./reddit.py joelthelion
User joelthelion has 6065 karma and 3876 comment karma

Pretty simple eh? DWM users can pipe this into their status bar
or this can be used in other ways. As well as telling you karma
it can also tell you if you have new mail. To do this use
the -m option. You will be prompted for your Reddit password

[phill@phillfed reddit_monitor]$ ./reddit.py -m philluminati
Your reddit password please: 
False

False means :-(
True means yay!

As I said there is a tray icon version. Just run:

./reddit_tray_icon.py

Fill out the dialog and that's pretty much all there is to it.
Anyway I hope you guys enjoy this.

Phillip (Philluminati) Taylor



--DISCLAIMER--

Use of this application may completely and utterly destroy any chance
of you ever doing any work again. Use with caution.



--KNOWN BUGS--

1. OK Button on password dialog isn't the default button. Doesn't
respond to enter (someone could patch this in 30 seconds I know it)

2. Reddit login process looks obfusicated. My app can't verify your
password or username are correct so please type them carefully. Test
with .reddit.py -m if you have troubles.

3. Some systems give an error importing pytrayicon with regards to a C
API version mismatch. This error isn't critical.

--ACKNOWLEDGEMENTS--
reddit.py was solved using firebug and this guide on cookies:
http://www.voidspace.org.uk/python/articles/cookielib.shtml

The tray icon stuff and gtk dialog were pretty much ripped
from Gmail Notifier: http://gmail-notify.sourceforge.net/


--LICENSE--
GNU GPL version 3



--TESTED AGAINST--
Fedora 9, GNOME, x86_64
Fedora 10, KDE 4+, 32 bit



--ABOUT THE AUTHOR--
Phillip (Philluminati) Taylor
25 years old
B.Sc. HONS Software Engineering
I currently write Python code professionally for a Gambling company
in London. It's all web based so excuse my GTK stuff.



--GETTING INVOLVED--
Please feel free to submit patches to add support where needed
or other features. Also, note, there is absolutely no way I'm
going to contribute to a piece of software that is designed
specifically to game Reddit. That is strictly not my intention.