November 16, 2008

Mumbles with gmail

I have been playing around with mumbles lately and have written a gmail plugin for anyone interested. Mumbles is a notification system that works very much like growl for the mac. The latest SVN version can even replace the gnome notification daemon (but not very well). While still in its infancy, this project shows a lot of promise. I based the plugin on the evolution tutorial on project's homepage. I based the script on this script (with many modifications). When you click on the notification popup, evolution will launch (you can edit the source to change the program). The script requires python-feedparser.
Plugin, Source, and Script package: gmail-plugin_mumbles.tar.gz
Installing the precompiled plugin:
Do step 2 from the next section. Now copy the plugin to '~/.mumbles/plugins/'.
Installing the plugin from source (adapted from dot_j's tutorial):
1. Download the source
Download the package and extract. Then open a terminal window inside the plugin-source folder.

2. Create the directory structure and choose an icon
Run the following commands:
mkdir ~/.mumbles (if you need to, but you shouldn’t) mkdir -p ~/.mumbles/plugins/icons
Then either run this to use the default evolution icon...
cp /usr/share/icons/hicolor/22×22/apps/evolution.png ~/.mumbles/plugins/icons
Or just copy your desired icon into the plugins/icons folder and rename it to evolution.png. This is unnecessary if you already have the evolution plugin.

Build and install the plugin
cd ~/gmail_plugin (if you’re not already there)python setup.py bdist_egg
This will use our setup.py file to create our plugin. After it runs, you should see a file named
GmailMumbles-0.1-py2.5.egg
in the dist directory that was created by the build process. Here the -py2.5 part of the filename refers to what version of python you are using (it may vary, but if you are able to start mumbles, should not matter).
The .egg file is our plugin, so the only thing left to do is copy that to the mumbles plugin directory.
cp dist/GmailMumbles-0.1-py2.5.egg ~/.mumbles/plugins
Installing the script:
Find the script in the package and edit the username and password variables. Run this script with python /path/to/gmail.py (replace /path/to with the path to the script). By default, this script will check for new email every 2 minutes and and alert the user of new mail.

BTW: This script does not safely store the username and password. I may, in the distant future, make this script work with gnome-keyring but this is not likely. I hope that mumbles will soon get better notification-daemon support so that I can go back to using mail-notification.

2 comments:

Bryan Hutchison said...

I've a question: I've downloaded the script and the python plugin (thank you for posting it--I appreciate it).

I'm having troubles running the gmail.py script--but don't know the programming necessary to really troubleshoot it. The error I get is "ImportError: No module named feedparser."

Any tips? (you could send it to bryan@bryanhutchison.com if you don't wish to post it on the site)

Thanks.

Steven said...

You need to install python-feedparser

Post a Comment