1. Michael Shepanski
  2. conky-pkmeter

Overview

HTTPS SSH

PKMeter generates a conkyrc file with an output similar to what Gnometer for Rainmeter offers. The instructions below are for Ubuntu 12.04. An example of this conky theme can be seen here: http://i.imgur.com/28J1c.png

BASIC INSTALLATION

1.) Install conky and the required Ubuntu packages.
>> sudo apt-get install aptitude conky-all ttf-ubuntu-font-family >> sudo apt-get install python-dateutil hddtemp lm-sensors >> sudo chmod u+s /usr/sbin/hddtemp
2.) Setup lm-sensors allowing it to detect various sensors in your system.
Answer YES to all questions, including the last one that defaults to NO. >> sudo sensors-detect
3.) Download and install pkmeter to the python path. NOTE: This installs the
executable /usr/local/bin/genconkyrc.py as well as additional shared files to /usr/local/share/pkmeter. >> cd conky-pkmeter >> sudo python setup.py install
4.) Run genconkyrc.py once to generate the default ~/.pkmeter/config.py file
in your home directory. Once this is created, feel free to play around with the available settings within this file and run genconkyrc.py to generate the new a conkyrc file. >> genconkyrc.py
5.) Start conky with the following command:
>> conky -c ~/.pkmeter/conkyrc

IF YOU WANT TO AUTO-START CONKY ON BOOT

NOTE: Because of a bug in conky v1.8 you cannot start this conky script until your system uptime his at least 1 minute. Hence the sleep below. I believe this issue was fixed in conky v1.9.

Add the following command to your startup programs: >> /usr/local/share/pkmeter/bin/startpkmeter.sh

IF YOU WANT TO ENABLE UNICODE FONTS

Some meters may require unicode fonts to display correctly. For instance, the NowPlaying meter may want to display a song title in another language if that happens to be what you're listening to.

Install Unifont package and PKMeter should display better unicode characters. >> sudo apt-get install unifont

IF YOU WANT TO ENABLE WEATHER UNDERGROUND

If you would like to view the Weather Underground forecast information, you will need an APIKEY from their website. Don't worry, it's all free!

IF YOU WANT TO ENABLE GOOGLE CALENDAR

If you would like to enable Google Calendar to see a list of upcoming events, you will need to create a new Google API Application and copy your credentials to the settings.

  • Login to your Google Calendar.
  • Navigate to Settings >> Calendars >> [Calendar] >> Private Address
  • Click the XML button and copy the URL to your ~/.pkmeter/config.py file.
  • Optionally specify a color from the choices explained in the config file.

IF YOU WANT TO ENABLE SICKBEARD QUEUE

If you would like to view your Sickbeard queue, you will need to enable and copy the APIKEY from your sickbeard configuration to the settings.

  • Login to your Sickbeard install.
  • Navigate to Config >> General.
  • Check the API >> Enable API checkbox.
  • Generate and copy the APIKEY to your ~/.pkmeter/config.py file.

IF YOU WANT TO ENABLE NOW PLAYING ARTWORK

The Now Playing artwork can be obtained from LastFM. You will need to have a LastFM API account to get an APIKEY.

Some specific music players have extra dependancies. You should only install these if you plan on using the music players specified:

  • MediaPlayerDaemon: >> sudo apt-get install python-mpdclient

FREQUENTLY ASKED QUESTIONS

Q.) I keep seeing the message: "Conky: could not connect to hddtemp host" A.) This usually means you have hddtemp configured slightly incorrectly for

conky to access it. Try running the following command, answer the following: >> sudo dpkg-reconfigure hddtemp ## Allow regular user to use hddtemp? YES ## Should hddtemp be started at boot? YES ## Interface to listen on? 127.0.0.1 ## Port to listen on? 7634