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
- 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!
- Visit http://www.wunderground.com/weather/api/
- Signup for an API Key.
- Update your Key Settings to the CUMULUS PLAN for a 10-day forecast.
- Add your APIKEY to your ~/.pkmeter/config.py file.
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.
- Signup for a LastFM account: http://last.fm
- Signup for a LastFM API account: http://www.last.fm/api/account
- Copy the APIKEY to your ~/.pkmeter/config.py file.
- Install additional python requirements: >> sudo apt-get install python-stdeb python-imaging python-pip >> sudo pip install http://python-lastfm.googlecode.com/svn/trunk/
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