SuperKaramba is part of most Linux distributions as it is released with KDE 3.4 and later. On most distributions it can be found in a package named kdeutils (kdeutils3-extra on openSUSE not kde4-superkaramba!) or a special package named superkaramba (on K/Ubuntu).
If your distribution doesn't come with superkaramba or you want to install it manually you can find the source package here.
To compile the SuperKaramba package manually you will need the KDE development packages and the Python development packages. Both are shipped with your distribution. Beside that you will also need a working tool chain to be able to compile the sources. These will also come with your distribution.
To start themes automatically with the KDE start, you just need to keep SuperKaramba running with the desired themes when you log out of KDE. However this requires that KDE be configured to restore the previous session or a manually configured session. If KDE is configured to "Start with an empty session" upon login, use the Autostart directory method.
On some systems (e.g. openSUSE) or when KDE always starts with an empty session, this will not work. In this case you need to create a link to SuperKaramba in the Autostart directory of KDE (~/.kde/Autostart/).
For example, to autostart the fictitious "my.theme" create a file which is execute able called mytheme.desktop in ~/.kde/Autostart containing the following:
[Desktop Entry] Comment=link to autostart My theme Exec=superkaramba ~/my.theme Name=My Cool Theme StartupNotify=false Type=Application
If you are running Compiz and find that this causes the superkaramba app to launch but not show the themes. After checking, of course, that the references to the theme are correct e.g. if you find superkaramba telling you that the theme is running but you can't see anything on the desktop, you may try removing the mytheme.desktop file from ~/.kde/Autostart and replacing it with a shell script called mytheme.sh containing the following:
sleep 60 sh superkaramba <path_to_mytheme>/mytheme.theme
If your mytheme.theme is in your home directory this would be:
sleep 60 sh superkaramba ~/mytheme.theme
Next make superkaramba.sh executable as follows:
What this will do is allow compiz to get up and running before KDE tries to invoke the superkaramba launch.
If you want to use SuperKaramba themes in Plasma you have to first run the theme at least once in SuperKaramba. After that the theme will appear in the Plasma Widget Browser like normal widgets do.
Delete the file ~/.kde/share/config/superkarambarc
You are probably trying to run SuperKaramba with a window manager (Fluxbox, GNOME) that isn't supported by SuperKaramba. Unfortunately SuperKaramba is currently limited to KDE due to the high integration into the KDE framework.
This also can happen on KDE when using a desktop background that is a plain color or a tiled image.
If you use openSUSE you probably installed the package kde4-superkaramba. Remove that package and install the kdeutils3-extra package. See How to install SuperKaramba
You are probably trying to run SuperKaramba with a Window Manager (Fluxbox, GNOME) that isn't supported by SuperKaramba. Unfortunately SuperKaramba is currently limited to KDE due to the high integration into the KDE framework.
You are probably trying to run SuperKaramba with Compiz or Beryl. Unfortunately this is currently not fully supported with SuperKaramba. In Compiz-Fusion, the Fade to Desktop module is known to work better than the Show Desktop module.
Make sure that you are running KDE and not another window manager. If you are running Compiz-Fusion, while it is not supported, you can enable Compiz-Fusion's Window Rules module and enter a Window Match rule for the Below and Sticky entries as needed based on the name or class values (given in "Writing Compiz Window Match rules" below). As a last resort, try restarting X.
Or CompizConfig Settings Manager -> Utility -> Workarounds -> Check 'Make "on all desktops" windows "sticky"' and make sure '"On all desktops" sticky match' has a value of "all". YMMV ofanged1 ;)
Running SuperKaramba with Compiz, Beryl or the merged Compiz-Fusion project is not fully supported. However, it can be useful to use Window Match rules within Compiz to achieve the desired behavior. The following window matching rules are based off of xprop results for SuperKaramba. The most preferable rule to use for SuperKaramba specific behavior is either the name or the class rule. While the other rules will match SuperKaramba, it is easier for non-SuperKaramba windows to match as well.
(Note that Window Match rules are usually case-sensitive and cannot have spaces around the equals sign.)
class=Superkaramba name=superkaramba type=dock title=superkaramba
Themes configs are stored in ~/.superkaramba/
Sensors arguments are set in the 'sensor' argument of function like setImageSensor(), setTextSensor(), etc...
txt = karamba.createText(widget, 0, 0, 200, 20, "")
karamba.setTextSensor(widget, txt, 'SENSOR=DISK MOUNTPOINT="/" FORMAT="Free space: %f MB"')
If your question wasn't answered, you need some additional help or you want to contribute to SuperKaramba. Feel free to join us at #superkaramba on irc.freenode.net.