KMeleonWiki > Documentation > ConfigFiles

K-Meleon's Configuration Files

The configuration of K-Meleon is controlled by these four files:

• Menus (menus.cfg)
• Accelerators (accel.cfg)
• Macros (macros.cfg)
• Toolbars (toolbars.cfg)

Each profile that you create can have a different configuration by editing these files.

Note: In regarde to K-Meleon 1.1, the informations given on this page are partly outdated and incomplete. Please refer to kko's K-Meleon 1.x Reference (external).

Menus (menus.cfg)

The menus.cfg file is parsed top to bottom. It's only read in once. That means you have to define things above where they are eused.

• A line that starts with # is a comment and is ignored.
• A line with a { on it starts a menu. Everything before the { is the menu name.
• A line that has a } on it ends a menu. Everything else on the line is ignored.
• A line with a - on it adds a separator to the menu.
• A command that starts with a : adds a submenu to the menu.
• The & character will underline the following letter for use of keyboard shortcuts.
• A line that has an = on it is a menu item. Everything on the left of the = is displayed on the menu.
• You can use \t to insert a tab such as to separate labels from the key.
• On the right side of the = is the command id that the menu item corresponds to.

Note: In regarde to K-Meleon 1.1, these informations are partly outdated and incomplete. Please refer to kko's K-Meleon 1.x Reference (external).

Example

# This will create the main menu bar with the File menu,
# that when opened has the command to open a new window.

&File {
&New Window\tCtrl+N = ID_NEW_BROWSER
}

Main {
:&File
}

Accelerators (accel.cfg)

Accelerators are keyboard shortcuts that can be linked to internal functions of K-Meleon. They are stored in accel.cfg file.

As usual all lines starting with # are comments. Each accelerator definition consists of 2 parts separated by an = sign:

<keys>=<command>

<keys> -> The declaration of the combination of the keyboard keys (See next list of predefined key names). <command> -> The command itself, can be "ID_..." or "<pluginName>(<pluginCommand>)". Note that plugin commands are ignored when the addressed plugin is not present i.e. not loaded.

The keys

You can use a combination of any number of control key (Alt/Ctrl/Shift) and one normal key.

Control keys are:

CTRL
SHIFT
ALT

Normals keys are standard alphanumeric symbols (A-Z, 0-9, ", ', !, $) and the following constants:

  VK_MENU   (equal to ALT)
  VK_BACK
  VK_COMMA
  VK_EQUALS
  VK_PERIOD
  VK_TAB
  VK_RETURN   VK_EXECUTE
  VK_PAUSE
  VK_CAPITAL  (shift lock)
  VK_ESCAPE
  VK_SPACE
  VK_PRIOR    VK_PAGE_UP
  VK_NEXT     VK_PAGE_DOWN
  VK_END
  VK_HOME
  VK_LEFT
  VK_UP
  VK_RIGHT
  VK_DOWN
  VK_INSERT
  VK_DELETE
  VK_PRINT   VK_SNAPSHOT
  VK_CLEAR
  VK_SELECT
  VK_SEPARATOR

  VK_LWIN     (left Windows key)
  VK_RWIN     (right Windows key)
  VK_APPS     (menu key)

  VK_NUMPAD0
  VK_NUMPAD1
  VK_NUMPAD2
  VK_NUMPAD3
  VK_NUMPAD4
  VK_NUMPAD5
  VK_NUMPAD6
  VK_NUMPAD7
  VK_NUMPAD8
  VK_NUMPAD9
  VK_MULTIPLY (* on numpad)
  VK_ADD      (+ on numpad)
  VK_PLUS     (normal +, not numpad)
    Note: VK_PLUS is the code of the key, not the code of the symbol!
          If, for example, the + is accessed by pressing Shift and the key, then
          VK_PLUS corresponds to pressing the key only (without the Shift key).
  VK_SUBTRACT (- on numpad)
  VK_MINUS    (normal -, not numpad) (same remark as for VK_PLUS)
  VK_DECIMAL  (. on numpad)
  VK_DIVIDE   (/ on numpad)
  VK_F1   VK_HELP
  VK_F2
  VK_F3
  VK_F4
  VK_F5
  VK_F6
  VK_F7
  VK_F8
  VK_F9
  VK_F10
  VK_F11
  VK_F12
  VK_NUMLOCK

  VK_SCROLL

And for the mouse buttons:

  LButton
  MButton
  RButton

The commands

An accelerator can be linked to 3 types of elements:

• A command ID representing an internal function.
• A plugin command.
• A macro defined in macros.cfg.

Conditional accelerator definition

You can define accelerators dependent on the absence/presence of a plugin:

%ifplugin <pluginName>
        ...
%else
        ...
%endif

The %else part can be omitted (it's optional).

Example

CTRL O = ID_FILE_OPEN
CTRL ALT VK_F4   = ID_APP_EXIT
VK_ESCAPE = ID_NAV_STOP

# plugin function
CTRL D = bookmarks(add)


# macro function
CTRL VK_RETURN = macros(ctrl_enter)

Macros (macros.cfg)

Macros are stored in macros.cfg.
The macro language is explained in the Macro Language section. New macros are given in the Macro Library.

Note: In regarde to K-Meleon 1.1, these informations are partly outdated and incomplete. Please refer to kko's K-Meleon Macro Language reference (external).

Toolbars (toolbars.cfg)

Toolbars are stored in a file named toolbars.cfg. Each skin as its own file, and you can override the default file, by placing your own copy in your profile directory.
The file is constituted of a set of toolbars, which in turn are made of buttons.

The format is as follows:

ToolBar Name(16,16) {     # (width,height) is optional, defaults to (16,16)
  Button Name(16,16) {     # (width,height) is optional, defaults to toolbar dimensions
    Command | Menu Name     # command (required): ID command, plugin command, or macro
                       # | Menu name is optional (as defined in menus.cfg) and is showed with right click
    Tooltip text         # Tooltip text
    c:\toolhot.bmp[2]    # hot image (optional)
                            #   [2] (optional) is the zero based index of the image within the file, defaults to 0
    c:\toolcold.bmp[2]   # cold image (optional)
    c:\tooldead.bmp[2]   # disabled image (optional)
  }     # End of Button
  -                     # display a vertical separator
  Button 2 {
    Command 2
    Tooltip 2
  }
}     # End of Toolbar

# Note: No toolbar images = Text based toolbar with button names for images

Toolbar 2 {
  Button 1
  ...
  Button 2
  ...
}

The command is either a command ID, a plugin command or a macro.
If you don't specify any images in the toolbar, it will become a text toolbar showing the button names in place of images.

Examples

K-Meleon default toolbar:

IE-like toolbar: