Duncan
H.
02/08/1999
0.01.00
KDE
Kcontrol
theme manager

# KDE Control Center - KDE Theme Manager

## KDE Theme Manager: Installer

This KDE Theme Manager screen allows you to select the desktop Theme package you wish to install.

Themes customize some or all of: the appearance of the various screen elements (window borders, buttons, title bar, panel, etc.), the color scheme and background wall papers, sounds associated with various events. and standard icons.

The column on the left lists the available Theme packages. The packages shown are either global themes in the system Themes directory `$KDEDIR/share/apps/kthememgr/Themes` or local themes in your personal Themes directory `˜/.kde/share/apps/kthememgr/Themes`. The packages can either be gzipped tarballs or unpacked directories.

Click on a listed Theme to select it; its name will be highlighted and (if available) a picture showing its components will be displayed in the top right-hand box. Information about the Theme will be displayed in the lower right-hand box.

To activate the highlighted theme package, click on Apply. The contents of the package will be extracted to your Theme manager Work directory `˜/.kde/share/apps/kthememgr/Work`, and the various components will be copied to the KDE configuration directories which control the desktop. (Go to the next Contents screen to select which components of the Themes package to activate)

- Note: the image files for the various window elements (buttons, titlebar, etc.) are placed in the directory `˜/.kde/share/apps/kwm/pics/` and panel elements go in `˜/.kde/share/apps/kpanel/pics/`. To completely remove a Theme, you may need to delete the contents of these directories.

Clicking on OK will also apply the selected Theme package, and then close the Theme Manager.

If you click on the Extract button, the contents of the highlighted Theme package will be extracted into the Work directory without being applied to the desktop. This is useful if you are building a modified Theme package. If the Theme package is global, a local copy will also be added to your personal Themes directory.

The list of available Themes can be modified as follows:

- Click on New to create a new entry in the list. This cretes an empty subdirectory for the new Theme in the local Work directory.

- Click on Remove to delete a local Theme. (This button is inactive when the highlighted Theme is a global Theme.)

- Click on Import to import a Theme package into your local Themes directory.

- Click on Export to export the highlighted Theme package.

## Theme package contents

This screen lists the elements contained in the selected Theme package. and allows their selective installation to replace the corresponding elements of the Theme that is currently being used.

If the checkbox Uninstall parts of previous theme is selected, the previous theme files in the KDE configuration directories will be backed up with a `˜` extension; if the box is not checked, they will be overwritten.

A list of the possible elements of the Theme package is presented (Colors, Wallpapers, Panel, ... etc.). Each has a checkbox next to it, and is identified as available or empty, depending on whether or not this element is present in the highlighted theme package listed on the previous (Installer) screen. (Some Theme packages only contain a subset of the possible Theme elements.)

If they are listed as available, the checked items in this list of possible Theme elements will be installed into the appropriate KDE configuration directories when the Apply button is clicked. If items are left unchecked, the corresponding elements of the currently-running Theme package will be left unchanged when the Apply button is clicked.

The Clear button clears all the checkboxes for the list of Theme elements, and the Invert exchanges checked and unchecked items.

## About the package

This screen provides information (version, author, etc.) about the selected Theme package, and about the KDE Theme Manager.

## Authors

The KDE Theme Manager `kthememgr` is writtten by Stefan Taferner.