Signed-off-by: Mavridis Philippe <mavridisf@gmail.com> |
3 days ago | |
---|---|---|
Config | 3 days ago | |
styles | 3 days ago | |
tools | 3 days ago | |
.gitignore | 3 days ago | |
AnalogClock.py | 3 days ago | |
AppLibFinder.py | 3 days ago | |
ClockHand.py | 3 days ago | |
ConfigData.py | 3 days ago | |
ImageCache.py | 3 days ago | |
KClock.py | 3 days ago | |
KClock.theme | 3 days ago | |
KClockBase.py | 3 days ago | |
KClockWidget.py | 3 days ago | |
KarambaConfig.py | 3 days ago | |
README.md | 3 days ago | |
Style.py | 3 days ago | |
StyleInfo.py | 3 days ago | |
Styles.py | 3 days ago | |
icon.png | 3 days ago | |
maindata.xml | 3 days ago |
README.md
KClock
KClock is a Superkaramba theme which shows you an analog clock.
Enjoy!
Features
The KClock has the following features:
- Timezones - You can have multiple clocks on your desktop, each set to a different timezone
- Clock hands can be shaded (only if PIL or ImageMagick is installed, see below about auto detection).
- Option to remove the second hand. KClock will automatically reduce the update frequency from superkaramba if the second hand is not show.
- All clock hand images are cached, so reduce system overhead.
- All clocks styles are in svg format and so can be resized to any size (see auto detection of Inkscape or librsvg below).
- Extra clock styles can be added from the configuration menu. See below about adding the 'Color Clock Styles'.
- Clock styles can be removed from the configuration menu.
Dependencies
KClock will work with still work with the basic Python libraries. But to get extra features and functionality working with KClock we surggest that you have some of these libraries/applications installed:
- PIL (Python Image Library) - With this library KClock can draw the shading on the clock hands and rotate the clock hands with out seeing jagged edges. Image Magick - This provides the same functionality as PIL, but is stlightly slower and more resourse instense grapthic library
- PyTQt - The Python TQt library will provide a nicer interface to choosing the clock styles.
- Inkscape - Inkscape is used to resize the png images without loss of quality from 250 by 250 pixels and higher.
- librsvg - librsvg does basically the same as Inkscape, so if you do not have Inkscape installed you can install this lighter application instead.
- pytz - To get the timezone working you will need to install the python library pytz. See http://pytz.sourceforge.net. If you have pyqt installed then the Configuration window can install this library for you into the KClock/libs folder.
Note on PIL
This theme uses the Python Image Library (PIL) to resize the clock hands with antialias.
PIL is normaly distributed with Inkscape and Scribus, so you probably have it installed already.
If you do not have PIL then you can get more information at:
http://www.pythonware.com/products/pil/
Since we use PIL to draw the clock hands we need to save the image as a file
and then reload it into karamba. So we keep all of the images as a cache in
the following folder: ~/.superkaramba/KClock_cache/{Style Name}/
You can delete the cache folder at any time, but you may need to reload the clock widget to start drawing the hands again.
Original work
This version has been modified to work with Python3 and TQt.
Original work here: https://store.kde.org/p/1105302