Conky Pidgin Python Script

Ubuntu/Debian : All the script packages have now been copied into the Conky Companions PPA. Any package updates will be provided by the team through this new ppa. The ppa can be found here: https://launchpad.net/~conky-companions/+archive/ppa. To use this ppa first delete the old ppa files using this:

Warning, this will not ensure you are kept up-to-date. Only method 1 will do that

Method 3: Using tar.gz file

Extract all the contents of the tar.gz file to an appropriate folder, and edit the conkyPidgin script to point to the correct location where conkyPidgin.py is. The tar.gz file is available at the Conky Companions PPA site here: https://launchpad.net/~conky-compani.../ppa/+packages

Unless you are using a non-Debian based OS I don't suggest this. Users of Debian/Ubuntu flavour OS's should ideally use method 1.

Again will will not receive updates using this method. ONLY method 1 can do this for you

All further details on setup are orientated around the deb package based install, so may differ from what you choose your setup to be, if done using the tarball.

Usage Help

To use the script in conky in it's simplist form, you'll need an exec statement like this:

Code:

${execi 60 conkyPidgin}

To use a template for custom output, I suggest you read the README attached, and take a look at the example conkyrc and template files that are installed to "/usr/share/conkypidgin/example".

You can get the current help options at any time by running:

Code:

conkyPidgin -h

or

Code:

conkyPidgin --help

Code:

Usage: conkyPidgin [options]
Options:
-h, --help show this help message and exit
-t FILE, --template=FILE
Template file determining the format for each buddy's
data or account info. Use the following placeholders
for default buddy output: [name], [alias], [group],
[status], [status_message]. If outputting an account
listing use these placeholders: [name], [protocol],
[status]
-L, --accountlisting Show account listing with status rather than buddies
-o, --onlineonly Only show online buddies. If outputting account
listings this option limits it to enabled only.
-a, --availableonly Only show available buddies. If outputting account
listings this option limits it to enabled only.
-f, --offlineonly Only show offline buddies. If outputting account
listings this option limits it to disabled only.
-i LIST, --ignorelist=LIST
A comma delimited list of groups to ignore. Partial
text matches on group will be ignored if found
-I LIST, --includelist=LIST
A comma delimited list of groups to include. Partial
text matches on group will be included if found. The
ignorelist, if used, takes precedence. if this list is
omitted all groups will be included unless ignored.
-C TEXT, --chattingtext=TEXT
[default: Chatting] Text to use for chatting status
output
-A TEXT, --availabletext=TEXT
[default: Available] Text to use for available status
output
-U TEXT, --unavailabletext=TEXT
[default: Unavailable] Text to use for unavailable
status output
-N TEXT, --invisibletext=TEXT
[default: Invisible] Text to use for invisible status
output
-W TEXT, --awaytext=TEXT
[default: Away] Text to use for away status output
-M TEXT, --mobiletext=TEXT
[default: Mobile] Text to use for mobile status output
-F TEXT, --offlinetext=TEXT
[default: Offline] Text to use for offline status
output
-l NUMBER, --limit=NUMBER
[default: 0] Set a limit to the number of buddies
displayed, by default no limitation is made
-s, --sortbylogactivity
If used the list is sorted by most recent activity
first, this is useful when limiting the list size with
the limit option
-v, --verbose Request verbose output, not a good idea when running
through conky!
-V, --version Displays the version of the script.
--errorlogfile=FILE If a filepath is set, the script appends errors to the
filepath.
--infologfile=FILE If a filepath is set, the script appends info to the
filepath.

Re: Conky Pidgin Python Script

I looked at your repos and saw no pidgin version for hardy...are you going to write one? Cause that would be awesome

Nope, all intrepid from now on in...

If you follow the instructions it will work in hardy though

I just labelled every up as intrepid because there may be code I develop that won't work in hardy anymore....for now though all my scripts are fine in hardy. They are python based so should be fine for some time (until hardy is well out of date, i.e. python 2.5 is obsolete)

Re: Conky Pidgin Python Script

This is a simple script to display buddy info from Pidgin. The script talks to Pidgin using dbus and allows templates...

There is a README with the install and attached here, I suggest you give it atleast a quick once over!

Basic Install

Method 1: Using apt

Edit your sources.list file by running this:

Code:

gksudo gedit /etc/apt/sources.list

And add the following line on the end of the file, then save.

Code:

deb http://ppa.launchpad.net/m-buck/ubuntu intrepid main

Now that is done simply run the following to install (answering yes to the verification question)

Code:

sudo apt-get update && sudo apt-get install conkypidgin

Method 2: Using deb file

Download and run the attached .deb file

Warning, this will not ensure you are kept up-to-date. Only method 1 will do that

Method 3: Using tar.gz file

Extract all the contents of the attached tar.gz file to an appropriate folder, and edit the conkyDeluge script to point to the correct location where conkyDeluge.py is.

Unless you are using a non-Debian based OS I don't suggest this. Users of Debian/Ubuntu flavour OS's should ideally use method 1.

Again will will not receive updates using this method. ONLY method 1 can do this for you

All further details on setup are orientated around the deb package based install, so may differ from what you choose your setup to be, if done using the tarball.

Usage Help

To use the script in conky in it's simplist form, you'll need an exec statement like this:

Code:

${execi 60 conkyPidgin}

To use a template for custom output, I suggest you read the README attached, and take a look at the example conkyrc and template files that are installed to "/usr/share/conkypidgin/example".

You can get the current help options at any time by running:

Code:

conkyPidgin -h

or

Code:

conkyPidgin --help

Code:

Usage: conkyPidgin [options]
Options:
-h, --help show this help message and exit
-t FILE, --template=FILE
Template file determining the format for each buddy's
data. Use the following placeholders: [name], [alias],
[group], [status], [status_message].
-o, --onlineonly Only show online buddies
-a, --availableonly Only show available buddies
-i LIST, --ignorelist=LIST
A comma delimited list of groups to ignore. Partial
text matches on group will be ignored if found
-I LIST, --includelist=LIST
A comma delimited list of groups to include. Partial
text matches on group will be included if found. The
ignorelist, if used, takes precedence. if this list is
omitted all groups will be included unless ignored.
-C TEXT, --chattingtext=TEXT
[default: Chatting] Text to use for chatting status
output
-A TEXT, --availabletext=TEXT
[default: Available] Text to use for available status
output
-U TEXT, --unavailabletext=TEXT
[default: Unavailable] Text to use for unavailable
status output
-N TEXT, --invisibletext=TEXT
[default: Invisible] Text to use for invisible status
output
-W TEXT, --awaytext=TEXT
[default: Away] Text to use for away status output
-M TEXT, --mobiletext=TEXT
[default: Mobile] Text to use for mobile status output
-F TEXT, --offlinetext=TEXT
[default: Offline] Text to use for offline status
output
-v, --verbose Request verbose output, not a good idea when running
through conky!
-V, --version Displays the version of the script.
--errorlogfile=FILE If a filepath is set, the script appends errors to the
filepath.
--infologfile=FILE If a filepath is set, the script appends info to the
filepath.

Re: Conky Pidgin Python Script

thanks for all your usefull work, i use the forecast script constantly.

would love to use this , but i dont use pidgin. have you considered doing one for emesene?

I had a quick look at the source code for emesene and there doesn't seem to be a way to interrogate the app from outside of itself via dbus, it only seems to support plugins.

To be honest, I dont like the idea of implementing a script for a messenger app which only handles one protocol anyway.

Maybe when Empathy makes it's proper appearance it will attract the likes of yourself. I'll no doubt create a script to that at that time too, cause I'll be using it by then as well. http://live.gnome.org/Empathy