Digikam Theming Guide

Header 

! "Marine"
!  Digikam Theme by Me Great Self (2004 Aug)
Comments in the theme are done by using "!". The header is the place where you can add some comments, give credit to yourself...

Base Properties

base.color:                          #ffffff
text.regular.color:                  #000000
text.selected.color:                 #000000
text.special.regular.color:          #658857
text.special.selected.color:         #ffffff
base.color is the background color which shall be used for the thumbnail view on the right and album/tag tree on the left. text.regular.color is used for regular (unselected) text and text.selected.color is used for selected text. usually the selected region tends to be brighter or darker and the selected text needs to contrast with it. text.special.... are the colors which are used for rendering of some special text like the tags at the bottom of the thumbnails and the collection/date names in the left view.
The color specification is done by using one of the three following three formats:
  • named color: for eg, black, red, ...
  • html color: for eg, #ffffff
  • x11 color: for eg, rgb:dd/dd/89

Banner Properties

banner.color:                        #4BFF9C
banner.colorTo:                      #35B56F
banner.bevel:                        RAISED
banner.gradient:                     HORIZONTAL
banner.border:                       true
banner.borderColor:                  #2FA062
These specifications are used to render the banner at the top of the thumbnail view. banner.bevel indicates the type of bevel to use for the banner, possible choices are RAISED (for a raised appearance), SUNKEN (for a sunken appearance), FLAT (for a flat appearance). banner.gradient is used for rendering a gradient; the possible choices are SOLID (no gradient), HORIZONTAL (horizontal gradient), VERTICAL (vertical gradient), DIAGONAL (diagonal gradient). there are two color specifications: color and colorTo. if a SOLID gradient is specified only "color" is used, for other cases the gradient is rendered from "color" to "colorTo". banner.border indicates whether a border should be drawn around the banner, using banner.borderColor. set it to "true" for rendering a border and to "false" otherwise.

Thumbnail Properties

thumbnail.regular.color:             #E7FFF4
thumbnail.regular.colorTo:           #C4D8CF
thumbnail.regular.bevel:             RAISED
thumbnail.regular.gradient:          HORIZONTAL
thumbnail.regular.border:            true
thumbnail.regular.borderColor:       #769286

thumbnail.selected.color:            #4BFF9C
thumbnail.selected.colorTo:          #35B56F
thumbnail.selected.bevel:            RAISED
thumbnail.selected.gradient:         HORIZONTAL
thumbnail.selected.border:           true
thumbnail.selected.borderColor:      #2FA062
These specifications are used for rendering the thumbnails. .regular. is used for unselected thumbnails and .selected. for selected thumbnails. The specifications are similar to that of the banner.

Listview Properties

listview.regular.color:              #ffffff
listview.regular.bevel:              FLAT
listview.regular.gradient:           SOLID
listview.regular.border:             false

listview.selected.color:             #4BFF9C
listview.selected.colorTo:           #35B56F
listview.selected.bevel:             RAISED
listview.selected.gradient:          HORIZONTAL
listview.selected.border:            true
listview.selected.borderColor:       #2FA062
These are used for rendering the items on the left treeview. again, the specifications are same as that of the banner.

Notes:

  • Case sensitivity is important for specifiying the property names, but not for the property values.
  • System level installation of themes is done in $(INSTALLATION_PREFIX)/share/apps/digikam/themes and user level installation in $(HOME)/.kde/share/apps/digikam/themes
  • Theme names appear in the menu with the filename. Make sure to capitalize the first letter of the filename
  • Its not necessary to restart digikam if you modify the theme. switch to a different theme and switch back. But if you add a new theme, you will have to restart digikam for the new theme to be recognized.