KBFX Configurator @APPLICATION_VERSION@"> ]> 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; @APPLICATION_DATE@ @APPLICATION_VERSION@ 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: Using Plugins. Selecting an Application Group. Scroll up and down the application list. Type and locate an Application. Logout of the Desktop. Lock the Desktop. Launch the KBFX Configurator (the KBFX settings manager). Extra KBFX features: Double buffered Widgets to minimize flicker. Animated scroll bars. New Tooltip. New Control Manager. 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: Right-click on the kicker's panel, on which you want to place the KBFX button. Select "Add Applet to Panel..." in the context menu. Select "KBFX Spinx". A tooltip appears "KBFX Spinx Added". If you move your mouse over the button, a tooltip appears (turned off in the default configuration). If you want to skin the KBFX Start Button see this section. 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. The picture in the upper left corner is your "dude" icon. 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. 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. The arrows above and below the middle column are used to scroll up and down in the middle column. 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. 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.   <anchor id="kbfx_themes" />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.   <anchor id="kbfx_button" />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.   <anchor id="kbfx_fonts" />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.   <anchor id="kbfx_layout" />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.   <anchor id="kbfx_plugins" />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.   <anchor id="kbfx_tooltip" />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.   <anchor id="kbfx_style" />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 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 Change into the new directory: > cd kbfx-x.y.z-XXXXXXXX/ 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 <command>checkinstall</command> 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: 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 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. 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: 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" Set the flag "strigi" for the kbfx ebuild Emerge "clucene" 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: Install your distribution's package named "subversion" OR download and install it from subversion's homepage 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 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 Proceed with the compilation/installation of KBFX: > ./build.sh 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 <anchor id="howto-themes" />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): Create a folder with a name that is identical to the name you want for your theme. Put the necessary images/files inside it (see the above instructions for the images part). Create an archive of the folder (with ark/tar etc). 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;