In the master branch, the `theme/Default` directory contains the basic files needed for a theme. The two font directories need to be bundled into font files and all the files need to be bundled into one theme file (using [makebundle](https://github.com/kometbomb/klystron/wiki/CreatingBundles)). This can be automatized with the DIY kit (see below.)

# DIY kit #

Use this [theme kit](https://github.com/kometbomb/klystrack-theme-kit/releases) to easily create new themes based on the Default theme. It's as easy as editing a few image files, and then double-clicking on a batch file that does the bundling for you.

# Theme file contents #

**RGB 255 0 255 is the magic color for transparency (because it's a horrible color and should never be used.)**

**You can include either BMP or PNG version of any image file in the theme. E.g. if `bevel.bmp` doesn't exist in the theme, `bevel.png` will be used instead.**

Files and colors that do not exist in a theme will be taken from the default theme.

## colors.txt ##

This file contains the text color definitions. The while should contain definitions in the following format, each on its own line:

    color_name = 0xffffff
    another_color_name = 0x808080

The hexadecimal number is a RGB value.

You can also define color like this:

    color_name = another_color_name

You can do this only after another_color_name has been defined.

## bevel.bmp ##

This is the main graphics file. The first row has different bevel (patterned rectangle) styles, the bottom row has button decals. The bevels generally have a 4 pixel wide border and a 8x8 center that is repeated. Everything has to be 16x16.

Here are the horizontal indices (leftmost tile index is zero) for the graphics:
  * [bevdefs.h](https://github.com/kometbomb/klystron/blob/master/src/gui/bevdefs.h)
  * [mybevdefs.h](https://github.com/kometbomb/klystrack/blob/master/src/mybevdefs.h)

## vu.bmp ##

This file contains the VU meter graphics. The dimensions can be anything as long as they fit inside the pattern area.

## analyzor.bmp ##

This is the spectrum analyzer bar. The left side of the image is used as the "enabled" graphic and the right side is the "disabled" graphic. I.e. the right side is what is drawn in any case and the left side is the actual bar that's drawn over the disabled gfx.

The actual width of the bar will be the image width divided by two (since half of the image is the disabled graphic).

## logo.bmp ##

## 8x8.fnt, 7x6.fnt, tiny ##

The fonts can be changed but it is recommended that they have the same dimensions as the originals and that at least the 8x8 font is fixed width. Refer to the klystron manual for [more information](https://github.com/kometbomb/klystron/wiki/Fonts) on the font file format.