# The &kbfxconfigapp; Handbook

Siraj
Razick

    siraj@kdemail.net

PhobosK

    phobosk@mail.kbfx.org

Mensur
Nookie
Zahirovic

    nookie@mail.kbfx.org

Nathanael
Gogniat

    nathanael@mail.kbfx.org

2007
KBFX Team
&FDLNotice;
2007-05-16
0.4.9.3.1

KBFX is an alternative to the classical K-Menu button and it's menu.

It improves the user experience by enabling the user to set a bigger (and thus more visible) start button and by finally replacing the Win95-like K-Menu. But if you still want the old menu, because you're used to it, it is still available as an option in KBFX. We recommend, however, that you give the Spinx bar a try.

KDE
kbfxconfigapp
KBFX
Menu
Configurator

## Introduction

KBFX is an alternative to the classical K-Menu button and it's menu. It improves the user experience by enabling the user to set a bigger (and thus more visible) start button and by finally replacing the Win95-like K-Menu. But if you still want the old menu, because you're used to it, it is still available as an option in KBFX. We recommend, however, that you give the Spinx bar a try.

### KBFX features

Main KBFX features:

1. Using Plugins.

2. Selecting an Application Group.

3. Scroll up and down the application list.

4. Type and locate an Application.

5. Logout of the Desktop.

6. Lock the Desktop.

7. Launch the KBFX Configurator (the KBFX settings manager).

Extra KBFX features:

1. Double buffered Widgets to minimize flicker.

2. Animated scroll bars.

3. New Tooltip.

4. New Control Manager.

5. Drag & Drop Applications' Items support.

### KBFX History

KBFX was started on June 5th 2005 as a hobbyist project by Siraj Razick, born out of a spontaneous idea.

The reason was that Siraj didn't like the old K-Menu, which was quite a clone of the old Win95 Start menu. So he started coding. The first step provided merely the possibility to call the K-Menu via a button, that could have a different shape and size than the original K-Menu button, which has always been an icon of a square size. To change the default KBFX button, one still had to copy an image file to a certain location. After the first post in mid-June 05, KBFX has spread rapidly and it was nice to see that until end of June, there were already a dozen posts on kde-look with buttons and builds.

Mensur Zahirovic (called Nookie) joined Siraj on 5th of august, after Siraj met him on yahoo. Nookie is responsible for the Web-development and the Q&A. He also arranged the site www.kbfx.org, that replaces the previous site www.linuxlots.com/~siraj/plugin/kde.

After that, things began to speed up. Now KBFX is no longer just another button design for the K-Menu, but provides an alternative to it, that is in fact more sophisticated than the XP-Start menu.

### KBFX Development

KBFX version 0.4.9.3 is a complete rewrite of the old KBFX code eliminating all the negative points of the previous versions.

At the start we had a list of end requirements for version 0.4.9.3 and we developed each of the feature units, testing each and every class as it was developed. Apart from unit testing, the quality assurance managers periodically checked the quality of the product and the new releases that were made to the KBFX source repository. The Q&A always checked the product against the requirements that we had set to maximize quality. This way of development helped us to discover tons of bugs and fix them instantly, and so we debut with a rather clean and bug free KBFX.

It was really helpful to see many users around the world checking out the development release of KBFX from SVN, reporting and posting problems encountered and helping to add more stability and compatibility between distributions. Because of this, we know the supported platforms even before KBFX is 0.4.9.3 is released.

KBFX has been tested to work with all GCC3.x and GCC4.x compilers. It has been tested on systems running the distributions of Gentoo, Debian, Ubuntu, Suse, Slackware, Mango, Mandrake, PCLinuxOS and Fedora core. Unfortunately, compiling on FreeBSD systems is yet to be tested, but we plan to port KBFX to FreeBSD and PcBSD.

### KBFX Concepts

The KBFX Spinx Menu does not try to copy the WinXP Start menu. It is based on a different approach and concept. Following, the concepts of the traditional hierarchical structure and the new, flat indexed menu are described and compared, although the new menu structure is quite intuitive.

#### Hierarchical (Traditional) menu structure

The KDE K-Menu is a good example of a flat hierarchical menu. It organizes application shortcuts in a tree link structure, where it can expand and open a submenu, with entries displayed based on some logical order. This order may be task oriented, type oriented or just ordered alphabetically. To find and launch an application, the user needs to navigate through the submenus, until he reaches the leaf (leaf node). This approach is a direct adoption of the Microsoft Windows Start Menu. They introduced it with Windows 95/98/ME/NT/2000. This was certainly a huge usability advantage compared to the Windows 3.1 System with the program manager, but a lot has changed since these days. The Windows XP Start Menu is still based on this concept, although it is enhanced by the functionalities to pin applications to the left column and the automatically pinned most used applications. But still, a user must move the mouse over the half screen, if his menu has many submenus with other submenus, and the application is not one of his most used or pinned applications.

#### Flat indexed menu structure

The KBFX Spinx Menu uses a different approach – the flat indexed menu. With this type of menu it's very easy to navigate. On the left hand side, you are given the application categories. They can be task oriented or type oriented. On the right (middle) side of the menu, there are all the available applications listed that belong to the activated category. The advantage is evident - the menu reduces the mouse paths, so you can locate your applications very fast. The user sees all the categories at a glance and he can pick it without having to travel along a long list until he finds the end leaf. The speed of use is further enhanced by moving the most used and recently used applications on the top index, so that the most used applications are just one click away.

## Using KBFX

### Starting KBFX

The KBFX menu button is a starting point for the menu. It first has to be added to a kicker's panel. To add the KBFX Menu to a panel, proceed as following:

1. Right-click on the kicker's panel, on which you want to place the KBFX button.

2. Select "Add Applet to Panel..." in the context menu.

3. Select "KBFX Spinx".

4. A tooltip appears "KBFX Spinx Added".

5. If you move your mouse over the button, a tooltip appears (turned off in the default configuration).

6. If you want to skin the KBFX Start Button see this section.

7. If you want to, you can now remove the K-Menu button and move the KBFX to the desired place on the panel. To open the menu, just click on the button.

### Using the Spinx Menu

Here's a screenshot of the Spinx Menu
Screenshot of the the Spinx Menu

The Spinx Menu looks (depending on the skin) like the picture above. It consists of following elements.

1. The picture in the upper left corner is your "dude" icon.

2. In the left and right columns of the menu, the plugins are displayed. Click on a plugin section, to display it's content in the middle column. If you click on the plugin's name you can contract its sections.

3. In the middle column of the menu, the menu items of the selected plugin section are displayed. Usually the menu items are grouped. If you click on a group it will contract. There is an option in the KBFX Configurator to start all these groups contracted.

   You CAN drag and drop items FROM this part of the menu to your desktop, konqueror etc.

   You CAN NOT drag and drop items TO this part of the menu.

4. The arrows above and below the middle column are used to scroll up and down in the middle column.

5. In the upper right corner, you find a search field, which can help you finding a menu item. It is "search as you tipe" field. If you want to clear the search (or the search term) double click on the search icon in the field. If you type a command in the search field and press "Enter", the command will be started as if it has been typed in the "Run command..." dialog of K-menu.

6. In the lower right corner, you find two buttons, one to log out and one to lock the desktop.

### How to configure KBFX

Here you can find how to use the KBFX Configurator.

#### Choose the KBFX Theme

Here's a screenshot of the Themes Section of the KBFX Configurator
Screenshot of the Themes Section of the KBFX Configurator

Select default folder

  Here you can select the folder in which you keep all your themes.

The other options are self explanatory and have tooltips that can help you use them.

#### Skin the KBFX Button

Here's a screenshot of the Start Button Section of the KBFX Configurator
Screenshot of the Start Button Section of the KBFX Configurator

Here you can skin the button. There are three fields to fill. The first field is the field for the path to the picture for the default button state (Normal). The second field is for the picture of the button in pressed state (Pressed). The third field is for the picture of the button in hovered state (Hover). You can drag and drop images on the "Preview" place or on the file selector field of each button. The selected design can be seen in the preview area. Press the "Apply" button to apply the selected look.

You can skin the KBFX Start Button by selecting three images (Normal, Pressed and Hover) in any file manager, drag and drop them on the KBFX Start Button. In order this to work the images have to have in their name the respective state of the button, i.e. "pressed", "hover" or "normal". Here is an example of valid file names for the button: my_hover_dButton.png, my_pressed_dButton.png, my_normal_dButton.png .

Button Fade Transition Effect

  This allows you to turn ON or OFF the fade effect for the KBFX button. This effect makes transitions between the three images (normal, hover, pressed) animated. Here you can set the time for the fade effect in msec. This time should be greater than 20 msec and less than 1000 msec. If set to 0 the effect will be disabled.

The other options are self explanatory and have tooltips that can help you use them.

#### Set the Fonts of the KBFX Theme

Here's a screenshot of the Fonts Section of the KBFX Configurator
Screenshot of the Fonts Section of the KBFX Configurator

Here you can configure all the fonts (colors, points, style etc.) for the current theme.

EXPORT KBFXFONTRC FILE

  Use this button to export your font settings in order to share it with other KBFX users or if you want to create a theme by yourself (how to create your own themes you can find out in this chapter).

In the font settings for the tooltip only "Font Name" and "Font Color" are used. The other settings like "Font Style" and "Font size" are not used. This may change in future versions.

The other options are self explanatory and have tooltips that can help you use them.

#### Set the Layout of the KBFX Theme

Here's a screenshot of the Layout Section of the KBFX Configurator
Screenshot of the Layout Section of the KBFX Configurator

Here you can configure all the layout options for the current theme.

Make it 2/3 Panels buttons

  Use these buttons to force KBFX to auto-configure the current theme to the listed layouts.

EXPORT KBFXLAYOUTRC FILE

  Use this button to export your layout settings in order to share it with other KBFX users or if you want to create a theme by yourself (how to create your own themes you can find out in this chapter).

The other options are self explanatory and have tooltips that can help you use them.

#### Set the KBFX Plugins

Here's a screenshot of the Plugins Section of the KBFX Configurator
Screenshot of the Plugins Section of the KBFX Configurator

Here you can configure the plugins KBFX will use and where to place them - on the left or on the right column of the KBFX Menu.

The other options are self explanatory and have tooltips that can help you use them.

#### Set the Tooltip of the KBFX Button

Here's a screenshot of the Tooltip Section of the KBFX Configurator
Screenshot of the Tooltip Section of the KBFX Configurator

Here you can select if the tooltip is on or off and if the tooltip animation is on or off. In the field for the Tooltip text, you can change the tooltip text that will appear in the Tooltip balloon.

The other options are self explanatory and have tooltips that can help you use them.

#### Set the Style of the KBFX Menu

Here's a screenshot of the Menu Style Section of the KBFX Configurator
Screenshot of the Menu Style Section of the KBFX Configurator

Here you can select, whether you want to work with the KBFX SPINX or the KDE MENU. You just have to select the according option and press the "Apply" button.

## Questions and Answers

I have a question that is not covered by this documentation. Where I can get an answer?

You can search the KBFX Forum for an answer OR you can ask your question in the forum.

How can I contact you live?

Come to the #kbfx channel on irc.freenode.org

## Authors, Credits and License

&kbfxconfigapp;

Program Copyright (c) 2007 KBFX Team.

KBFX Team Managers:

- Siraj Razick siraj@kdemail.net

- PhobosK phobosk@kdemail.net

- Mensur Zahirovic nookie@mail.kbfx.org

- Nathanael Gogniat nathanael@mail.kbfx.org

Translations:

- Ferenc Stelcz ferenc@stelcz.hu - Hungary (HU)

- Divilinux divilinux@mail.kbfx.org - Italy (IT)

- Lexus lexus@mail.kbfx.org - Bulgaria (BG)

- PhobosK phobosk@kdemail.net - Bulgaria (BG)

- Monkey 9 monkey9@iae.nl - Netherlands (NL)

Contributors and Credits:

- Darwin M. Bautista djclue917@gmail.com - 001.patch

- Revaline C. Regendra regendra_mail7@yahoo.com - Author of the Launch button in the default "KBFX Silk TTP" theme.

  Copyright (c) 2006 Revaline^Studio

  Revaline's Launch Menu v4.0

- Petri Damstén damu@iki.fi - Author of the KMFFontChooser class. KMediaFactory

Documentation Copyright (c) 2007 PhobosK phobosk@mail.kbfx.org

&underFDL;

&underGPL;

## Installation

### How to obtain KBFX

KBFX can be downloaded from SourceForge project pages.

Sometimes development versions are uploaded in a separate space on SourceForge.

The SVN address of the KBFX project is on the KDE SVN servers.

### Requirements

In order to successfully compile and use KBFX, you need at least &kde; 3.4.X and also you need:

- Cmake - min. version 2.4.2

- KDE3 and Qt3 sources - header files/devel packages

- Strigi -this package is OPTIONAL and is used for files inline search

You can find the most recent KBFX's list of changes at KDE SVN.

### Compilation and Installation

1. Unpack the sources of KBFX with (x.y.z-XXXXXXXX represents the version of the KBFX package, for example 0.4.9.3-20070117):

       > tar xjvf kbfx-x.y.z-XXXXXXXX.tar.bz2

2. Change into the new directory:

       > cd kbfx-x.y.z-XXXXXXXX/

3. Start the configuration and the compilation using the command:

       > ./build.sh

#### Note for Mandriva < 2007 users:

The build script (by default) enables the use of `menudrake` instead of `kmenuedit`. If you want to prevent this behavior then pass ONE of these options to the build script: `--menudrake-off` OR `-m`

#### Other building options:

- `--prefix` OR `-p` to install KBFX in a different than the default folder (default is KDE install folder) for example:

      > ./build.sh -p /home/user

- `--strigi` OR `-s` to enable Strigi support in KBFX (default is no Strigi support)

- `--kde4` OR `-k` to build KBFX for KDE4 (default is for KDE3)

- `--verbose` OR `-v` to make the build script give more verbose information

- `--nocheck` OR `-n` to make the build script not to check if an old KBFX version is installed (default is to check)

### Using `checkinstall`

`checkinstall` is an application used to build distribution specific packages from sources.

`checkinstall` DOES NOT work with cmake correctly up to this moment. :(

It can be used with additional commands in order to "work properly". Here is the procedure to follow as user (NOT as ROOT) in order to obtain the necessary distribution package.

- x.y.z-XXXXXXXX represents the version of the KBFX package, in this example it is: 0.4.9.3-20070117

- In the example here the version string is replaced only in the checkinstall command but you have to do that everywhere the "x.y.z-XXXXXXXX" string is met.

    > cd /tmp
    > tar xjvf kbfx-x.y.z-XXXXXXXX.tar.bz2
    > cd kbfx-x.y.z-XXXXXXXX/
    > mkdir -p build/package
    > cd build
    > export DESTDIR=/tmp/kbfx-x.y.z-XXXXXXXX/build/package
    > cmake  ../ -DCMAKE_INSTALL_PREFIX=`kde-config --prefix`
    > make install DESTDIR=/tmp/kbfx-x.y.z-XXXXXXXX/build/package
    > find package/|sed s#^package/#./# > installed_files.txt
    > cd package/
    > su
    > checkinstall -nodoc --pkgname="kbfx" --pkgversion="0.4.9.3" \
    --pkgrelease="20070117" --exclude="/" --include=../installed_files.txt \
    --pakdir=/tmp/kbfx-0.4.9.3-20070117 sleep 1

When ready, "checkinstall" will show you the folder where the prepared package is, like in this Mandriva Example:

    **********************************************************************

    Done. The new package has been saved to

    /tmp/kbfx-0.4.9.3-20070117/kbfx-0.4.9.3-20070117.i386.rpm
    You can install it in your system anytime using:

    rpm -i kbfx-0.4.9.3-20070117.i386.rpm

    **********************************************************************

Of course the best way to make RPM packages is to use the "kbfx.spec" file provided in the KBFX sources like described bellow.

### RPM Building Instructions (Mandriva, Fedora, Suse)

If you prefer manipulate a RPM, you can build it with the following commands:

1. Build the RPM:

       > rpmbuild -tb kbfx-x.y.z-XXXXXXXX.tar.bz2

   or (for Mandriva)

       > rpmbuild --rebuild kbfx-x.y.z-XXXXXXXX-mdv20070.src.rpm

   or (for Fedora)

       > rpmbuild --rebuild kbfx-x.y.z-XXXXXXXX-FCx.src.rpm

   or (for SuSe)

       > rpmbuild --rebuild kbfx-x.y.z-XXXXXXXX-suseXXX.src.rpm

2. If succeed, you will found the rpm in /usr/src/rpm/RPMS (for Mandriva) or /usr/src/redhat/RPMS (for Fedora) or /usr/src/packages/RPMS (for Suse) according to the platform you have.

3. Install the rpm as usually by:

       > rpm -Uvh kbfx-x.y.z-XXXXXXXX.rpm

#### Building RPM from KBFX SVN versions:

- Follow these commands in the sources directory:

      > ./build.sh

  Answer "N" to the question if you want to install KBFX.

      > cd build
      > make dist

- A file "kbfx-x.y.z-XXXXXXXX.tar.bz2" will be created in the build directory.

- Proceed with the steps described in 1., 2., 3.

### Gentoo users

In order to use the strigi engine in KBFX you have to do these steps:

1. Copy the "strigi-X.X.X.ebuild" and the "kbfx-0.4.9.X.ebuild" (from the sources directory) to your local portage tree as needed OR use the "kbfx-0.4.9.X-portage-overlay.tar.bz2"

2. Set the flag "strigi" for the kbfx ebuild

3. Emerge "clucene"

4. Emerge "kbfx"

There is a Layman overlay resource on the SourceForge SVN. You can add it by this command:

    > layman -f -o https://kbfx.svn.sourceforge.net/svnroot/kbfx/layman/kbfx-overlay.xml \
      -a kbfx

After you add the "kbfx" overlay you can use it as usual.

### SVN version

To download the latest development source, you need to go to KDE SVN and download it from there. The current SVN address of the repository is: svn://anonsvn.kde.org/home/kde/trunk/playground/base/kbfx_plasma

Here are the instructions on how to get a copy of the SVN Repository:

1. Install your distribution's package named "subversion" OR download and install it from subversion's homepage

2. Create a folder where you will compile/install KBFX and enter in it. For example do this:

       > mkdir -p ~/usr/src/svn
       > cd ~/usr/src/svn

3. Checkout the SVN version of KBFX in this way and proceed as follows:

       > svn co svn://anonsvn.kde.org/home/kde/trunk/playground/base/kbfx_plasma
       > cd  kbfx_plasma

4. Proceed with the compilation/installation of KBFX:

       > ./build.sh

5. If you want always to have the latest version of KBFX you may leave the folder "~/usr/src/svn/kbfx_plasma" intact for future use. When you want to update the source files of KBFX you just need to do `svn up` in this folder, delete the folder "~/usr/src/svn/kbfx_plasma/build" and start the `./build.sh` script i.e:

       > cd ~/usr/src/svn/kbfx_plasma
       > svn up
       > rm -fR build
       > ./build.sh

## How To

### How to create themes for KBFX

So you want to create your own themes for KBFX 0.4.9.3?

The guide is done in a simple manner and we hope that you will easily and simply create themes for KBFX 0.4.9.3. If you don't like something in this guide, please feel free to contact us at IRC on irc.freenode.org on channel #kbfx

- The values for Width and Height are only our suggested values. You can use whatever values you feel are appropriate for your theme.

- If ANY of these images are missing KBFX will use the image with the same name from the "default" theme.

- In order to be used by the Configurator and by KBFX, every theme for 0.4.9.3 MUST HAVE a file in it's folder named "version-2" !

#### Images in KBFX

Here's a screenshot of all the images used in KBFX Menu
Screenshot of all the images used in KBFX Menu

This image is showing you all the images which are used in KBFX 0.4.9.3. The most simple way to create a theme at this point is to take some of the images from the "default" theme and just change colors on some and see how that effects your menu.

DO NOT EVER CHANGE ANY IMAGE IN THE DEFAULT FOLDER!

The images there are used as fallback when there is a missing image in your own theme. We suggest rather to work with a copy folder of the default theme (the name of the folder containing your theme of course should be not "default" ;) ).

topbg.png

  topbg.png

  This is an image that is at the top of the menu.

  Width = 504px and Height = 95px

dudebox.png

  dudebox.png

  This is the background image where your personal image is displayed.

  Width = 95px and Height = 88px

menu_top_image_person.png

  menu_top_image_person.png

  This image is used for theme's default personal image.

  Width = 48px and Height = 48px

find.png

  find.png

  This is a small image displayed in the search field.

  Width = 22px and Height = 21px

rhstile.png

  rhstile.png

  This is normal image displayed in categories.

  Width = 132px and Height = 23px

rhshovertile.png

  rhshovertile.png

  This is a hover image for categories. Used as hover image for rhstile.png

  Width = 132px and Height = 23px

scrollnormal.png / scrollnormalbot.png

  scrollnormal.png

  These images are used as top and bottom scrollbars.

  Width = 240px and Height = 10px

separator.png / indexseparator.png

  separator.png

  These are the separator images which separate your different subcategories.

  Width = 240px and Height = 27px

tilenormal.png

  tilenormal.png

  This is the normal image where your applications are showed.

  Width = 240px and Height = 46px

tilehover.png

  tilehover.png

  This is the hover image where your applications are showed.

  Width = 240px and Height = 46px

listboxbg.png

  listboxbg.png

  This is the background under the categories. It can be viewed on description on both sides of the menu.

  Width = 108px and Height = 23px

middleboxbg.png

  middleboxbg.png

  This is the background of the middle part of the menu.

  Width = 200px and Height = 270px

botbg.png

  botbg.png

  This is the background image at the bottom of the menu.

  Width = 504px and Height = 38px

lock.png

  lock.png

  This is the lock image.

  Width = 84px and Height = 38px

lockhover.png

  lockhover.png

  This is the lock hover image.

  Width = 84px and Height = 38px

logout.png

  logout.png

  This is the logout image.

  Width = 84px and Height = 38px

logouthover.png

  logouthover.png

  This is the logout hover image.

  Width = 84px and Height = 38px

mask.png

  mask.png

  This is deciding what size your menu will have when users install it and which will be the transparent parts of the menu (through the alpha mask of the png image). Of course the size can be controlled later by the configuration of KBFX.

  Width = 504px and Height = 513px

logo.png

  logo.png

  This is used as a theme's or author's logo shown in the Information box of the KBFX Configurator. You can put whatever image you want and it will be scaled to 100px width by 100px height.

  Width = 100px and Height = 100px

preview.png

  preview.png

  This should be a snapshot of the working KBFX theme. It is used in the configuration application in order the user to see what the theme will look like.

  Width = 170px and Height = 205px

normal.png / hover.png / pressed.png

  normal.png hover.png pressed.png

  These are the KBFX Buttons for the kicker panel that are used in the theme. Width and Height - as you like, but preferably Height not to be too much.

More information can be found on our homepage here

#### "kbfxfontrc" and "kbfxlayoutrc" files

Every theme MAY have two configuration files named:

- kbfxfontrc - configures the fonts properties that the theme uses.

- kbfxlayoutrc - configures the layout of the theme, the KBFX button and some other properties of the theme.

If one or both of these files don't exist, KBFX internal configuration options will be used for fonts and layout. All the properties and values are separated between different Sections in the way showed below:

    	[Section]
    	property = value

When you want to prepare a theme, have in mind that every change that you make in the "KBFX Configurator" is kept in files in your home KDE directory.

Usually these files are in the folder ~/.kde/share/apps/kbfx/themerc and are named:

- THEMENAME_layoutrc

- THEMENAME_fontrc

So if you want to ship your theme settings from the "KBFX Configurator", the best thing to do is to use the buttons: "EXPORT KBFXFONTRC FILE" ("Fonts" section of the Configurator) and "EXPORT KBFXLAYOUTRC FILE" ("Layout section" of the Configurator) and put the exported files in your theme folder.

- Pay close attention to the case of the properties and Sections names because the configuration is CASE SENSITIVE!

- The order of the sections in the file is not important!

- Have in mind that the Layout of the theme also depends on the sizes of the images!

##### File kbfxfontrc

- It's best the colors to be represented in RGB format.

- Font Properties should constrain to QFont class representation.

- The values bellow are the default ones.

    	[Fonts]
    	TooltipText=0,0,0
    	TooltipTextFont=Arial,8,-1,5,50,0,0,0,0,0
    	ApplicationText=0,0,0
    	ApplicationTextFont=Arial,8,-1,5,50,0,0,0,0,0
    	CommentText=128,125,0
    	CommentTextFont=Arial,8,-1,5,50,0,0,0,0,0
    	GroupText=0,0,0
    	GroupTextFont=Arial,8,-1,5,50,0,0,0,0,0
    	UserName=255,255,255
    	UserNameFont=Arial,10,-1,5,75,0,0,0,0,0
    	SeparatorColor=0,0,0
    	SeparatorFont=Arial,8,-1,5,50,0,0,0,0,0
    	PluginColor=0,0,0
    	PluginFont=Arial,8,-1,5,50,0,0,0,0,0
    	LineColor=255,220,125
    	# This is if the font when you hover on an item will be bold
    	HoverBold = false

##### File kbfxlayoutrc

- The values bellow are the default ones.

    	[KbfxButton]
    	# Time in msec for which the button
    	# to fade in/out
    	FadeTime=75
    	# The three properties below describe the
    	# paths to the theme's buttons.
    	# KBFX uses the normal.png/hover.png/pressed.png
    	# that are in the theme's folder by default.
    	# So we recommend NOT to use the below three
    	# properties!
    	Normal = KBFX Normal Button Full Path
    	Hover = KBFX Hover Button Full Path
    	Press = KBFX Pressed Button Full Path

    	[TopBar]
    	# Face Position X
    	DudeX=-1
    	# Face Position Y
    	DudeY=-1
    	# Face Box Height
    	FaceH=64
    	# Face Box Width
    	FaceW=65
    	# Face Box Position X
    	FaceX=27
    	# Face Box Position Y
    	FaceY=8
    	# User Name Position X
    	UserNameX=130
    	# User Name Position Y
    	UserNameY=32
    	# Hide User Name
    	DisableUserName=false
    	# Top Bar Height
    	Height=95
    	# THE PROPERTIES BELOW ARE NOT USED FOR NOW
    	# Top Bar Width
    	Width=504
    	# Top Bar Position X
    	X=0
    	# Top Bar Position Y
    	Y=0

    	[BottomBar]
    	# Bottom Bar Height
    	Height=38
    	# THE PROPERTIES BELOW ARE NOT USED FOR NOW
    	# Bottom Bar Width
    	Width=504
    	# Bottom Bar Position X
    	X=0
    	# Bottom Bar Position Y
    	Y=428

    	[Scrollbars]
    	# THIS SECTION IS NOT USED FOR NOW
    	# Bottom Scroll Bar Position X
    	ScrollBarBotX=108
    	# Bottom Scroll Bar Position Y
    	ScrollBarBotY=95
    	# Top Scroll Bar Position X
    	ScrollBarTopX=108
    	# Top Scroll Bar Position Y
    	ScrollBarTopY=95

    	[ListBox]
    	# List Box Position X
    	X=0
    	# List Box Position Y
    	Y=95
    	# List Box Width
    	Width=132
    	# THE PROPERTIES BELOW ARE NOT USED FOR NOW
    	# List Box Height
    	Height=275

    	[SearchBox]
    	# Search Box Height
    	Height=22
    	# Search Box Width
    	Width=240
    	# Search Box Position X
    	X=130
    	# Search Box Position Y
    	Y=48

    	[ItemView]
    	# Item Position X
    	X=132
    	# Item Position Y
    	Y=95
    	# Item Width
    	Width=240
    	# THE PROPERTIES BELOW ARE NOT USED FOR NOW
    	# Item Height
    	Height=275

    	[ItemProperties]
    	# Comment Margin in Item
    	CommentMargin=66
    	# Icon Size in Item
    	IconSize=32
    	# No Comments in Item
    	NoComments=false

    	[ToolBar]
    	# THIS SECTION IS NOT USED FOR NOW
    	# Tool Bar Button Normal Size
    	ButtonNormalSize=48
    	# Tool Bar Button Pressed Size
    	ButtonPressedSize=48

    	[MainMenu]
    	# Main Menu Height
    	UserMenuHeight=513
    	# Main Menu Width
    	UserMenuWidth=504
    	# Contracted Menues
    	ContractedMenu=false

#### "version-2" file

- This file is OBLIGATORY to exist, though it can be empty. It is used to designate that the theme is in the new format and the properties that are in the file are used in the KBFX Configurator for showing the user some info about the theme.

- The values in this file cannot be overwritten by the KBFX Configurator.

- If existing, the file should contain information about the theme's version, author's name, author's email and a homepage for the theme.

- The unspecified fields are replaced with the string - "Not Specified".

- The values bellow are self explanatory and are just an example.

    	[ThemeGeneral]
    	ThemeVersion=0.51
    	AuthorName=Nookie
    	AuthorEmail=nookie@no_spam.org
    	Homepage=http://www.kbfx.org

Now we wish you all good luck when creating themes. We are looking forward to all your good looking themes out there for the KBFX!

### How to create a ".kbfxtheme" file

The ".kbfxtheme" file is a simple archive file (.tar.gz or .tar.bz2) that should contain at least these elements:

- One or more theme folders with all the necessary images/files inside. Have in mind that the name of the theme is the name of the folder.

- In the theme(s) folder(s) there should be an image named "preview.png" that serves as a live preview of the look of the theme.

- In the theme(s) folder(s) there should be a file named "version-2"

- The extension of the archive should be ".kbfxtheme"

You can create ".kbfxtheme" file following these instructions (there is an option in Konqueror's rightclick "Actions" menu for preparing KBFX Theme Package OR you can create the ".kbfxtheme" file manually as described bellow):

1. Create a folder with a name that is identical to the name you want for your theme.

2. Put the necessary images/files inside it (see the above instructions for the images part).

3. Create an archive of the folder (with ark/tar etc).

4. Rename the archive file to ".kbfxtheme" and you are ready.

### How to help us out for KBFX

You can help us for the KBFX releases with the translation of the interface. For this purpose please download the kbfxconfigapp.pot file from SourceForge and use KBabel or poEdit to make the translation.

Next send the .po file to my mail phobosk@mail.kbfx.org.

Another way to get a .pot file is to use the command: `make package-messages` just after the configuration of the compilation process is done.

Thanks in advance for this help.

## Useful links

KBFX Homepage

KBFX SourceForge project page

KBFX Releases

KBFX Forum

KBFX Bugs

&documentation.index;