Results 1 to 10 of 195

Thread: Conky Pidgin Python Script

Threaded View

  1. #1
    Join Date
    Feb 2008

    Conky Pidgin Python Script

    ArchLinux : Package support is present in the AUR. All my packages can be seen here:

    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: To use this ppa first delete the old ppa files using this:
    sudo rm /etc/apt/sources.list.d/m-buck* && sudo rm /etc/apt/sources.list.d/conkyhardcore*
    Then follow the modified first post instructions for the scripts


    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, I suggest you give it atleast a quick once over! It can be found in the installation folder, normally following the path of /usr/share/conky<scriptname>/

    Basic Install

    Method 1: Using apt

    1) Add the repository to your OS install:
    sudo add-apt-repository ppa:conky-companions/ppa
    * Note if you are running 9.10 or below then refer to the PPA link at the end of this post for help on installing from the ppa, good guidance can be found on the launchpad site

    2) Now that is done simply run the following to update your repo cache and install the script:

    sudo apt-get update && sudo apt-get install conkypidgin
    Method 2: Using deb file

    Run the .deb file available at the Conky Companions PPA site here:

    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 is. The tar.gz file is available at the Conky Companions PPA site here:

    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:

    ${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:

    conkyPidgin -h

    conkyPidgin --help
    Usage: conkyPidgin [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],
      -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
      -A TEXT, --availabletext=TEXT
                            [default: Available] Text to use for available status
      -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
      -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
      -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
      --infologfile=FILE    If a filepath is set, the script appends info to the
    Development History

    Development history going forwards can be seen here
    All packages available from me can be found here:
    Attached Images Attached Images
    Last edited by kaivalagi; December 14th, 2010 at 11:25 PM.

Tags for this Thread


Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts