1. INTRODUCTION
Xmms-kde themes consists of two parts. The configuration file and the data file.
The data file is a tar.gz packed file and contains all the images you use in your theme. The configuration file describes what parts of your theme that are sensitive to mouse presses, sizes, e.g.
Allthough you normally give the configuration file and the data file the same names (but with different extensions) this is not mandatory and you can specify your own name on the data file in the configuration. And remember, the best way to find out if you are wondering about anything is to look at what others have done. You can find other themes in the Themes dir in the distribution directory.

1.1 Overall theme design
The base of all themes is the main background image. The main background image should contain all the buttons and toggles except the seekers in their default position. If you want you can supply aditional graphics for the buttons and the toggles that will be shown when the touch sensitive areas are pressed.

2. THE CONFIGURATION FILE
Here follows a listing of all the fields that are possible to have in the configuration file and what type they are of. Notation: [field name] - "Description". Usage in config file: "field name"="value" without the quotes. Fields marked with optional are optional all others are mandatory

2.1 [BITMAPS]
file - The data file containing the bitmaps that you use compressed as an tar.gz archive
main - The main background bitmap.
seek - The seek button bitmap.
volume - The volume button bitmap
 
back - The back pressed button bitmap. (optional)
next - The next pressed  button bitmap. (optional)
pause - The pause pressed  button bitmap. (optional)
stop - The stop pressed  button bitmap. (optional)
play - The play pressed  button bitmap. (optional)
 
shuffleon - Shuffle on pressed button bitmap. (optional)
repeaton - Repeat on pressed button bitmap. (optional)
 
2.2 [CONTROL]
back - The touch sensitive area for the back button. [x, y, w, h]
pause - The touch sensitive area for the pause button. [x, y, w, h]
play - The touch sensitive area for the play button. [x, y, w, h]
skip - The touch sensitive area for the skip button. [x, y, w, h]
stop - The touch sensitive area for the stop button. [x, y, w, h]
 
2.3 [SEEK]
area - The touch sensitive area where the song seeker is. [x, y, w, h]
 
2.4[SIZE]
height - Total height for your applet
width - Total width for your applet
 
2.5[TIME]
color - Color of the time text. [R,G,B]  (optional)
font=times,9,5,0,50,0 - Font of the time text.  (optional)
played - Position of the played time. [x, y] (top left corner)
total - Position of the total time. [x, y] (top left corner)
 
2.6[TITLE]  
color - Color of the title text. [R,G,B] (optional)
font - Font of the title text. (optional)
ypos- Y position of the title text. A number smaller than 0 means disabled. [y]
clip - Clip rect of the title [x, y, w, h]
 
2.7[VOLUME]
area - The touch sensitive area  where the volume seeker is. [x, y, w, h]
 
2.8[TOGGLES]
shuffle - The touch sensitive area for the shuffle button. [x, y, w, h] (optional)
repeat - The touch sensitive area for the repeat button. [x, y, w, h] (optional)

3. Example configuration file
[BITMAPS]
file=horizontal25.tgz
main=main.png
seek=seek.png
volume=volume.png

back=back.png
next=next.png
pause=pause.png
stop=stop.png
play=play.png

shuffleon=shuffleon.png
repeaton=repeaton.png

[CONTROL]
back=0,15,13,10
pause=26,15,13,10
play=13,15,13,10
skip=52,15,13,10
stop=39,15,13,10

[SEEK]
area=5,9,45,6

[SIZE]
height=25
width=65

[TIME]
color=200,200,200
font=times,9,5,0,50,0
played=0,-2
total=30,-2

## if ypos < 0 it is not used.
[TITLE]
color=100,100,100
font=clean,8,4,0,50,0  
ypos=-50
clip=0,0,0,0

[VOLUME]
area=5,1,45,6

[TOGGLES]
shuffle=55,0,10,6
repeat=55,7,10,6

