conkyguayadeque

Conky

People using conky can install a plugin called conkyguayadeque. There is also a thread at ubuntu-forums.

In Ubuntu you first have to add the repository via:

sudo add-apt-repository ppa:conky-companions/ppa

and install it...

sudo apt-get update && sudo apt-get install conkyguayadeque

ArchLinux users can get it from AUR directly or via yaourt:

yaourt -S conkyguayadeque

Gentoo users can install it from sunrise-overlay. If you haven't already added sunrise-overlay you can do it with layman

layman -a sunrise

First we have to unmask conkyguayadeque, because all packages in sunrise are masked 'untested'

echo "app-admin/conkyguayadeque **" >> /etc/portage/package.accept_keywords

Then install via

emerge -av conkyguayadeque

There are two ways we can implement this plugin in our conky process: we can use a template file which defines the functions to be shown or we simply call all functions directly in our conkyrc. An example for the template file can be found in
/usr/share/conkyguayadeque/example/conkyGuayadeque.template and can look like this:

${color1}Artist: ${color}[--datatype=AR]
${color1}Album: ${color}[--datatype=AL]
${color1}Title: ${color}[--datatype=TI]
${color1}Position: ${color}[--datatype=PT]/[--datatype=LE] - [--datatype=PP]%
${color1}Rating: ${color}[--datatype=RT]
${color1}Volume: ${color}[--datatype=VO]

I have created my own template in /home/user/.conkyGuayadeque.template and have added this line to my conkyrc:

${execp conkyGuayadeque --template=~/.conkyGuayadeque.template}

A direct call of functions would look similar to this:

${color1}Album: ${color}${exec conkyGuayadeque --datatype=AL}
${color1}Title: ${color}${exec conkyGuayadeque --datatype=TI}
${color1}Position: ${color}${exec conkyGuayadeque --datatype=PT}/${exec conkyGuayadeque --datatype=LE}

Possible values for datatypes are (in bold): status: ST coverart: CA title: TI album: AL artist: AR genre: GE year: YR track number: TN file name: FN bitrate: BR length: LE current position in percent: PP current position in time: PT volume: VO rating: RT
Check the README and the example conkyrc in
/usr/share/conkyguayadeque/example/conkyrc too.