KMeleonWiki > Documentation > ConfigFiles

Menus?

Accelerators?

Macros?

Toolbars?

The configuration of K-Meleon is controlled by these four files. Each profile that you create can have a different configuration by editing these files.

Menus

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 used.

• 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.

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

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

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

• the declaration of the combination of the keyboard keys
• the command itself

The keys

You can use a combination of any number of control key (shift/alt/ctrl) and one normal key.

Control keys are: CTRL SHIFT ALT
Normals keys are standard alphanumeric symbols (az,09, "'!$) and the following constants:

  VK_BACK
  VK_TAB
  VK_RETURN
  VK_PAUSE
  VK_CAPITAL (shift lock)
  VK_ESCAPE
  VK_SPACE
  VK_PRIOR (page up)
  VK_NEXT (page down)
  VK_END
  VK_HOME
  VK_LEFT
  VK_UP
  VK_RIGHT
  VK_DOWN
  VK_INSERT
  VK_DELETE
  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: is the code of the key, not the symbol
    example: if the '+' is accessed when pressing 'shift' and the key,
        VK_PLUS corresponds to pressing the key only (without any control key).
  VK_SUBTRACT (- on numpad)
  VK_MINUS (normal -, not numpad) (same remarks as for VK_PLUS)
  VK_DECIMAL (. on numpad)
  VK_DIVIDE (/ on numpad)
  VK_F1
  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:

  LButton
  RButton
  MButton

The commands

An accelerator can be linked to 3 types of elements:

• an internal functions represented by command ID's
• a plugin function. Currently available function are described here.
• a macro function as defined in macros.cfg. The syntax is currently described here.

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 are stored in macros.cfg.
The macro language is explained here.
New macros are given here.

Toolbars