## K-Meleon Quick Reference

##### K-Meleon Version 1.6.X - Recopilated by: desga2 - Revised: 2010/12/11 (KM 1.6Beta2)

I N D E X

Index
Command Line Options
Mouse Accelerators
Special Keys to Accel
Accelerators Keys
Command IDs
Plugin Commands
Documentation Online

## Command Line Options

Parameter | Effect
-chrome | If the browser window hosting chrome or content. (old option, useless?)
-new | Starts a new browser instance. Available since K-Meleon 1.1.
-norestrict | K-Meleon 1.5.1 try to run itself with lower privilege by default. This option remove the security restriction added in 1.5.1. Available since K-Meleon 1.5.2.
-P mostrecent | Starts K-Meleon with the most recently used profile.
-P "profile name" | Starts K-Meleon with the specified profile.
-profilesDir $appdata | Starts K-Meleon with the profile location set to the %AppData% directory (overriding profile.ini).
-profilesDir "path" | Starts K-Meleon with the profile location set to the specified directory (overriding profile.ini).
"URL" | Starts K-Meleon with the specified URL (overriding homepage settings).
-webapp | Starts K-Meleon in kiosk mode. Available since K-Meleon 1.5.

######

More info about this in K-Meleon Documentation online.

INDEX

## Mouse Accelerators

You can found this accels definitions in accel.kmm file in folder \K-Meleon\macros.
You can change this configuration in menu Tools -> Mouse Accelerators.

Action | Default | Firefox 2.0 | SeaMonkey 1.1 | Opera 9.2
Ctrl+LeftClick | Open in foreground. | Open in background. | Open in background. | (nothing).
Shift+LeftClick | Open in foreground. | Open in new window. | Save link target. | Open in foreground.
Ctrl+Shift+LeftClick | (nothing). | Open in foreground. | Open in foreground. | Open in background.
Alt+Shift+LeftClick | (nothing). | (nothing). | (nothing). | Open in foreground.
Ctrl+Alt+Shift+LeftClick | (nothing). | (nothing). | (nothing). | Open in background.
MiddleClick | Open in foreground. | Open in background. | Open in background. | Open in background.
Shift+MiddleClick | (nothing). | Open in foreground. | Open in foreground. | (nothing).
Ctrl+RightClick | Open in background. | Open in foreground. | Open in foreground. | (nothing).

######

More info about this in K-Meleon Documentation online.

INDEX

## Special Keys to Accelerators

KM Key | Control Key
CTRL | Control key
SHIFT | Shift key
ALT | Alternative key
KM Key | Normal Keys
A-Z, a-z, 0-9, rest of symbols | A-Z, a-z, 0-9, rest of symbols
KM Key | Function key
VK_F1 | F1
VK_F2 | F2
VK_F3 | F3
VK_F4 | F4
VK_F5 | F5
VK_F6 | F6
VK_F7 | F7
VK_F8 | F8
VK_F9 | F9
VK_F10 | F10
VK_F11 | F11
VK_F12 | F12
KM Key | System key
VK_LWIN | Left Windows key
VK_RWIN | Right Windows key
VK_APPS | Menu key

KM Key | Special Key
VK_ESCAPE | Escape key
VK_TAB | Tabulator key
VK_CAPITAL | Caps lock key
VK_BACK | Backspace
VK_RETURN | Return key
VK_SPACE | Spacebar key
VK_MENU | Alt Gr key
VK_PLUS | +
VK_MINUS | -
VK_PRINT VK_SNAPSHOT | Print Screen key (not work for accels)
VK_SCROLL | Scroll Lock key
VK_PAUSE | Pause key
VK_INSERT | Insert key
VK_DELETE | Delete key
VK_HOME | Home key
VK_END | End key
VK_PRIOR VK_PAGE_UP | Page Up key
VK_NEXT VK_PAGE_DOWN | Page Down key
KM Key | Cursor Key
VK_LEFT | Left cursor key
VK_UP | Up cursor key
VK_DOWN | Down cursor key
VK_RIGHT | Right cursor key

KM Key | Keypad
VK_NUMLOCK | Num Lock key
VK_DIVIDE | /
VK_MULTIPLY | *
VK_SUBTRACT | -
VK_ADD | +
VK_DECIMAL | .
VK_NUMPAD0 | 0
VK_NUMPAD1 | 1
VK_NUMPAD2 | 2
VK_NUMPAD3 | 3
VK_NUMPAD4 | 4
VK_NUMPAD5 | 5
VK_NUMPAD6 | 6
VK_NUMPAD7 | 7
VK_NUMPAD8 | 8
VK_NUMPAD9 | 9
KM Key | Mouse button
LButton | Left button
MButton | Middle button
RButton | Right button

######

More info about this in K-Meleon Documentation online.

INDEX

## Default Accelerators Keys

You can found this default accelerators in accel.cfg file in folder \K-Meleon\defaults\settings.
Or defined in the corresponding macro file with setaccel() macro function.

KM Accelerator | Function | Action
Link Handling
MButton | ID_OPEN_LINK_IN_NEW_TAB | ID_OPEN_LINK_IN_NEW_WINDOW | Middle-click open links to new tab/window.
#MButton | ID_OPEN_LINK_IN_BACKGROUNDTAB | ID_OPEN_LINK_IN_BACKGROUND | Middle-click open links to new background tab/window. This is commented, is optional.
CTRL LButton | ID_OPEN_LINK_IN_NEW_TAB | ID_OPEN_LINK_IN_NEW_WINDOW | Ctrl+Left-click links to new tabs/windows.
SHIFT LButton | ID_OPEN_LINK_IN_NEW_WINDOW | ID_OPEN_LINK_IN_NEW_WINDOW | Shift+Left-click links to new tabs/windows.
CTRL RButton | ID_OPEN_LINK_IN_BACKGROUNDTAB | ID_OPEN_LINK_IN_BACKGROUND | Ctrl+Right-click links to background tab/window.
ALT LButton | ID_COPY_LINK_LOCATION | Alt+Left-click link urls to the clipboard for download managers to catch them.
Window/Tab Handling
#ALT VK_F4 | ID_FILE_CLOSE | Close current active window. This is commented, because Alt+F4 is a system keys shortcut.
CTRL VK_F4 | ID_CLOSE_TAB | Close current active tab.
CTRL SHIFT VK_F4 | ID_CLOSE_ALLTAB | Close all tabs.
SHIFT VK_F4 | ID_CLOSE_ALLOTHERTAB | Close all others tabs except the current active tab.
CTRL ALT VK_F4 | ID_APP_EXIT | Exit K-Meleon, close all K-Meleon windows.
CTRL VK_TAB | ID_TAB_NEXT | ID_WINDOW_NEXT | Go to next tab/window.
CTRL SHIFT VK_TAB | ID_TAB_PREV | ID_WINDOW_PREV | Go to previous tab/window.
CTRL VK_PRIOR | ID_TAB_PREV | Go to previous tab.
CTRL VK_NEXT | ID_TAB_NEXT | Go to next tab.
CTRL ALT VK_TAB | ID_TAB_LAST | Go to last previous selected tab.
CTRL VK_F7 | ID_WINDOW_NEXT | Go to next K-Meleon window.
CTRL SHIFT VK_F7 | ID_WINDOW_PREV | Go to previous K-Meleon window.
ALT VK_LEFT | ID_NAV_BACK | Go back one page.
ALT VK_RIGHT | ID_NAV_FORWARD | Go forward one page.
ALT VK_HOME | ID_NAV_HOME | Load Home page.
SHIFT VK_BACK | ID_NAV_BACK | Go back one page.
VK_ESCAPE | ID_NAV_STOP | Stop loading current page.
Function Keys
VK_F1 | ID_LINK_KMELEON_MANUAL | Load K-Meleon User's Guide and Reference Manual web page.
VK_F2 | ID_PREFERENCES | Open Preferences panel.
VK_F3 | ID_EDIT_FINDNEXT | Find next occurrence searched.
SHIFT VK_F3 | ID_EDIT_FINDPREV | Find previous occurrence searched.
VK_F5 | ID_NAV_RELOAD | Reload current page.
CTRL VK_F5 | ID_NAV_FORCE_RELOAD | Force reload current page.
SHIFT VK_F5 | ID_NAV_FORCE_RELOAD | Force reload current page.
VK_F6 | ID_SELECT_URL | Select text in URL bar adress.
VK_F11 | fullscreen() | Toggle to fullscreen mode.
General
CTRL SHIFT S | ID_VIEW_STATUS_BAR | Hide or show the status bar.
CTRL A | ID_EDIT_SELECT_ALL | Select all text. This is commented, because Ctrl+A is a system keys shortcut.
CTRL B | bookmarks(edit) | Open Bookmarks editor.
#CTRL C | ID_EDIT_COPY | Copy selected to clipboard. This is commented, because Ctrl+C is a system keys shortcut.
CTRL D | bookmarks(add) | Adds the page to bookmarks.
CTRL F | ID_EDIT_FIND | Show Find bar at bottom.
CTRL G | ID_NAV_SEARCH | Open Web Search prompt. If text is selected, searchs the selected text in web search engine.
CTRL H | history(View) | Opens the history window.
CTRL I | ID_VIEW_PAGE_INFO | Show a new window with the current page info.
CTRL L | ID_SELECT_URL | Select text in URL bar adress.
CTRL N | ID_NEW_BROWSER | Opens a new K-Meleon window.
CTRL O | ID_FILE_OPEN | Show Open file dialog.
CTRL P | ID_FILE_PRINT | Open Print dialog.
CTRL R | ID_NAV_RELOAD | Reload current page.
CTRL S | ID_FILE_SAVE_AS | Open Save As file dialog.
CTRL T | ID_NEW_TAB | Open new tab.
CTRL U | ID_VIEW_SOURCE | Open a new window with the source code of current page.
#CTRL V | ID_EDIT_PASTE | Paste the contents of the clipboard. This is commented, because Ctrl+V is a system keys shortcut.
CTRL W | ID_CLOSE_TAB | ID_FILE_CLOSE | Close current tab/window.
#CTRL X | ID_EDIT_CUT | Cut out the selected text (Copy selected text to the clipboard before deleting it). This is commented, because Ctrl+X is a system keys shortcut.
CTRL Y | ID_EDIT_REDO | Redo the latest undo changes. This is commented, because Ctrl+Y is a system keys shortcut.
CTRL Z | ID_EDIT_UNDO | Undo the latest changes. This is commented, because Ctrl+Z is a system keys shortcut.
CTRL ALT S | sessions(Save) | Save the current session.
CTRL ALT P | ID_FILE_PRINTPREVIEW | Toggle to print preview.
CTRL ALT W | ID_CLOSE_ALLOTHERTAB | Close all other tabs but not current active tab.
CTRL ALT Z | sessions(Undo) | Undo last closed tab/window.
CTRL SHIFT R | ID_NAV_FORCE_RELOAD | Force reload of current page.
CTRL SHIFT W | ID_CLOSE_ALLTAB | Close all tabs.
Zoom
CTRL VK_PLUS | ID_FULLZOOM_INCREASE | Full zoom into the current page.
CTRL VK_ADD | ID_FULLZOOM_INCREASE | Full zoom into the current page.
CTRL VK_MINUS | ID_FULLZOOM_DECREASE | Full zoom out of the current page.
CTRL VK_SUBTRACT | ID_FULLZOOM_DECREASE | Full zoom out of the current page.
Defined by Macros: accel.kmm
CTRL LButton | ID_OPEN_LINK_IN_NEW_TAB | ID_OPEN_LINK_IN_NEW_WINDOW | Default K-Meleon.
SHIFT LButton | ID_OPEN_LINK_IN_NEW_TAB | ID_OPEN_LINK_IN_NEW_WINDOW | Default K-Meleon.
CTRL SHIFT LButton | (not defined) | Default K-Meleon.
ALT SHIFT LButton | (not defined) | Default K-Meleon.
CTRL ALT SHIFT LButton | (not defined) | Default K-Meleon.
MButton | ID_OPEN_LINK_IN_NEW_TAB | ID_OPEN_LINK_IN_NEW_WINDOW | Default K-Meleon.
SHIFT MButton | (not defined) | Default K-Meleon.
CTRL RButton | ID_OPEN_LINK_IN_BACKGROUNDTAB | ID_OPEN_LINK_IN_BACKGROUND | Default K-Meleon.
CTRL LButton | (not defined) | Opera 9.2.
SHIFT LButton | ID_OPEN_LINK_IN_NEW_TAB | ID_OPEN_LINK_IN_NEW_WINDOW | Opera 9.2.
CTRL SHIFT LButton | ID_OPEN_LINK_IN_BACKGROUNDTAB | ID_OPEN_LINK_IN_BACKGROUND | Opera 9.2.
ALT SHIFT LButton | ID_OPEN_LINK_IN_NEW_TAB | ID_OPEN_LINK_IN_NEW_WINDOW | Opera 9.2.
CTRL ALT SHIFT LButton | ID_OPEN_LINK_IN_BACKGROUNDTAB | ID_OPEN_LINK_IN_BACKGROUND | Opera 9.2.
MButton | ID_OPEN_LINK_IN_BACKGROUNDTAB | ID_OPEN_LINK_IN_BACKGROUND | Opera 9.2.
SHIFT MButton | (not defined) | Opera 9.2.
CTRL RButton | (not defined) | Opera 9.2.
CTRL LButton | ID_OPEN_LINK_IN_BACKGROUNDTAB | ID_OPEN_LINK_IN_BACKGROUND | Mozilla browsers (FF & SM).
CTRL SHIFT LButton | ID_OPEN_LINK_IN_NEW_TAB | ID_OPEN_LINK_IN_NEW_WINDOW | Mozilla browsers (FF & SM).
ALT SHIFT LButton | (not defined) | Mozilla browsers (FF & SM).
CTRL ALT SHIFT LButton | (not defined) | Mozilla browsers (FF & SM).
MButton | ID_OPEN_LINK_IN_BACKGROUNDTAB | ID_OPEN_LINK_IN_BACKGROUND | Mozilla browsers (FF & SM).
SHIFT MButton | ID_OPEN_LINK_IN_NEW_TAB | ID_OPEN_LINK_IN_NEW_WINDOW | Mozilla browsers (FF & SM).
CTRL RButton | ID_OPEN_LINK_IN_NEW_TAB | ID_OPEN_LINK_IN_NEW_WINDOW | Mozilla browsers (FF & SM).
SHIFT LButton | ID_OPEN_LINK_IN_NEW_WINDOW | Firefox 2.
SHIFT LButton | ID_SAVE_LINK_AS | Seamonkey 1.1.
ALT D | ID_SELECT_URL | Default K-Meleon.
Defined by Macros: domcomplete.kmm
CTRL VK_RETURN | macros(domComplete(0)) | Manual domain completion: www.<URL>.com
CTRL ALT VK_RETURN | macros(domComplete(1)) | Manual domain completion: www.<URL>.net
CTRL SHIFT VK_RETURN | macros(domComplete(2)) | Manual domain completion: www.<URL>.org
Defined by Macros: hotlink.kmm
CTRL [0-9] | macros(hotlink(0-9)) | Hotlinks Ctrl+[0-9] to open defined web pages.
Defined by Macros: ie.kmm
CTRL ALT I | macros(IE_OpenPage) | Open current page in IE.
Defined by Macros: main.kmm
CTRL ALT O | macros(OpenURL) | Prompt for an URL to open.
VK_F7 | macros(pref_ToggleJavaScript) | Toggle JavaScript execution.
VK_F8 | macros(pref_TogglePopups) | Toggle popup blocking.
VK_F9 | macros(pref_ToggleImages) | Toggle image loading.
CTRL ALT N | macros(Go_New) | Open URL Bar contents in a new page.
CTRL ALT V | macros(Go_Paste) | Open Clipboard contents as URL.
Defined by Macros: search.kmm
CTRL G | macros(Search) | Consult the default search engine.
SHIFT VK_RETURN | macros(Search) | Consult the default search engine.
CTRL SHIFT V | macros(Search_PasteAndSearch) | Search the Web for Clipboard contents.
Defined by Macros: zoom.kmm
ALT VK_PLUS | macros(Zoom_Images_In) | Increase image size.
ALT VK_ADD | macros(Zoom_Images_In) | Increase image size.
ALT VK_MINUS | macros(Zoom_Images_Out) | Decrease image size.
ALT VK_SUBTRACT | macros(Zoom_Images_Out) | Decrease image size.
CTRL ALT VK_PLUS | ID_FONT_INCREASE | Increase the font size in the current page.
CTRL ALT VK_ADD | ID_FONT_INCREASE | Increase the font size in the current page.
CTRL ALT VK_MINUS | ID_FONT_DECREASE | Decrease the font size in the current page.
CTRL ALT VK_SUBTRACT | ID_FONT_DECREASE | Decrease the font size in the current page.

######

No more info available about this in K-Meleon Documentation online yet.

INDEX

## Command IDs

COMMAND ID | FUNCTION
ID_APP_ABOUT | Opens the 'About K-Meleon' dialog.
ID_APP_EXIT | Terminates K-Meleon.
ID_CLOSE_ALLOTHERTAB | Close all other tabs but not current active tab.
ID_CLOSE_ALLTAB | Close all tabs.
ID_CLOSE_TAB | Close current active tab.
ID_COOKIE_PERM | Open Cookie Manager dialog.
ID_COOKIES_VIEWER | Open Cookies Viewer dialog.
ID_COPY_IMAGE_CONTENT | Copies the image to clipboard.
ID_COPY_IMAGE_LOCATION | Copy image location to the clipboard.
ID_COPY_LINK_LOCATION | Copy link location to the clipboard.
ID_EDIT_CLEAR | Delete the selected text.
ID_EDIT_COPY | Copy selected text to the clipboard.
ID_EDIT_CUT | Cut out the selected text. (Copy selected text to the clipboard before deleting it)
ID_EDIT_FIND | Open the search dialog.
ID_EDIT_FINDNEXT | Search forward.
ID_EDIT_FINDPREV | Search backward.
ID_EDIT_PASTE | Paste in the text from clipboard.
ID_EDIT_REDO | Redo the latest undo changes.
ID_EDIT_SELECT_ALL | Select all text.
ID_EDIT_SELECT_NONE | Clear the selection.
ID_EDIT_UNDO | Undo the latest changes.
ID_FILE_CLOSE | Close the open file.
ID_FILE_OPEN | Bring up the open file dialog.
ID_FILE_PRINT | Open the print dialog.
ID_FILE_PRINTPREVIEW | Enter print preview mode. Select again to leave.
ID_FILE_PRINTSETUP | Opens the page setup dialog.
ID_FILE_SAVE_AS | Open the 'Save as ...' dialog.
ID_FILE_SAVE_FRAME_AS | Open the 'Save as ...' dialog to save selected frame.
ID_FONT_DECREASE | Decrease the font size.
ID_FONT_INCREASE | Increase the font size.
ID_FULLZOOM_DECREASE | Decrease full page zoom, the font and images size.
ID_FULLZOOM_INCREASE | Increase full page zoom, the font and images size.
ID_IMAGE_PERM | Open Image Manager dialog.
ID_LINK_ABOUT_PLUGINS | Display installed plugins list.
ID_LINK_KMELEON_FORUM | Go to the K-Meleon forums.
ID_LINK_KMELEON_HOME | Go to the K-Meleon home page.
ID_LINK_KMELEON_MANUAL | Go to the K-Meleon online documentation.
ID_LINK_KMELEON_FAQ | Go to the K-Meleon FAQ online.
ID_MANAGE_PROFILES | Open the profiles manager/selector.
ID_MAXIMIZE_WINDOW | Maximize K-Meleon active window.
ID_MINIMIZE_WINDOW | Minimize K-Meleon active window.
ID_NAV_BACK | Go back one page.
ID_NAV_FORWARD | Go forward one page.
ID_NAV_FORCE_RELOAD | Reload current page without cache query.
ID_NAV_GO | Go to URL.
ID_NAV_HOME | Go to home page.
ID_NAV_RELOAD | Reload current page.
ID_NAV_SEARCH | Calls the search dialog. See the preference for kmeleon.general.searchEngine
ID_NAV_STOP | Stop loading.
ID_NEW_BROWSER | Open a new browser window.
ID_NEW_TAB | Open a new tab.
ID_OFFLINE | Toggle browser online/offline.
ID_OPEN_FRAME | Opens the selected frame.
ID_OPEN_FRAME_IN_BACKGROUND | Opens the selected frame in a new background window.
ID_OPEN_FRAME_IN_BACKGROUNDTAB | Opens the selected frame in a new background tab.
ID_OPEN_FRAME_IN_NEW_TAB | Opens the selected frame in a new tab.
ID_OPEN_FRAME_IN_NEW_WINDOW | Opens the selected frame in a new window.
ID_OPEN_LINK | Opens the active link in the current browser window.
ID_OPEN_LINK_IN_BACKGROUND | Opens the active link in a new browser window placed in the background.
ID_OPEN_LINK_IN_BACKGROUNDTAB | Opens the active link in a new tab in the background.
ID_OPEN_LINK_IN_NEW_TAB | Opens the active link in a new tab in the foreground.
ID_OPEN_LINK_IN_NEW_WINDOW | Opens the active link in a new browser window placed in the foreground.
ID_PASSWORDS_VIEWER | Open Passwords Viewer dialog.
ID_POPUP_PERM | Open Popup Manager dialog.
ID_PREFERENCES | Opens the preference/configuration panel.
ID_RESTORE_WINDOW | Restore the previous size of the K-Meleon active window.
ID_SAVE_IMAGE_AS | Save an image.
ID_SAVE_LINK_AS | Save a link.
ID_SELECT_URL | Select the text of the URL.
ID_TAB_LAST | Go to previously selected tab.
ID_TAB_NEXT | Go to next tab.
ID_TAB_PREV | Go to previous tab.
ID_TOGGLE_WINDOW | Toggle window size to maximized of the K-Meleon active window.
ID_TOOLBARS_LOCK | Locks the toolbars from being moved manualy.
ID_VIEW_FRAME_INFO | Display frame info in cache.
ID_VIEW_FRAME_SOURCE | View the frame source.
ID_VIEW_IMAGE | View an image.
ID_VIEW_PAGE_INFO | Display page info in cache.
ID_VIEW_SOURCE | View page source.
ID_VIEW_STATUS_BAR | Toggle statusbar.
ID_VIEW_TOOLBAR | Toggle toolbar.
ID_WINDOW_NEXT | Switch to next browser window.
ID_WINDOW_PREV | Switch to previous browser window.

######

More info about this in K-Meleon Documentation online.

INDEX

## Plugin Commands

These commands are provided by the kplugins (plugins for K-Meleon) and it's the dll files that you find the folder \K-Meleon\kplugins.

Bmpmenu Plugin | Function | Available in
bmpmenu() | Show icons in menu. | Menus
Bookmarks Plugin | Function | Available in
bookmarks() | Show bookmarks in a menu list. | Menus
bookmarks(Add) | Adds the page to bookmarks. | Accel, Menus, Toolbars
bookmarks(AddLink) | Adds the selected link to bookmarks. | Menus
bookmarks(AddToolbar) | Add the selected link to bookmarks bar. | Accel, Menus, Toolbars
bookmarks(Config) | Opens bookmarks plugin configurations. | Accel, Menus, Toolbars
bookmarks(Edit) | Opens the 'Edit bookmarks' window. | Accel, Menus, Toolbars
plugin(bookmarks, "Config"); plugin(bookmarks, "Add"); plugin(bookmarks, "AddToolbar"); plugin(bookmarks, "Edit"); plugin(bookmarks, "AddLink");
$page = pluginmsgex(bookmarks, "FindNick", $nickname, STRING);
Same as previous descriptions.
Macros
INDEX

Favorites Plugin | Function | Available in
favorites() | Show favorites in a menu list. | Menus
favorites(Add) | Adds the page to favorites. | Accel, Menus, Toolbars
favorites(AddLink) | Adds the selected link to favorites. | Menus
favorites(Config) | Opens favorites plugin configurations. | Accel, Menus, Toolbars
favorites(Edit) | Opens the favorites folder in Windows Explorer. | Accel, Menus, Toolbars
plugin(favorites, "Config"); plugin(favorites, "Add"); plugin(favorites, "Edit"); plugin(favorites, "AddLink"); $page = pluginmsgex(bookmarks, "FindNick", $nickname, STRING); | Same as previous descriptions. | Macros
INDEX

Fullscreen Plugin | Function | Available in
fullscreen() | Toggles fullscreen. | Accel, Menus, Toolbars
plugin(fullscreen); | Toggles fullscreen. | Macros
INDEX

Gestures Plugin | Function | Available in
- | Gestures plugin can't be called. You can configure Mouse Gestures from Preferences. | None

History Plugin | Function | Available in
history() | Show history in a menu list. | Menus
history(View) | Opens the history window. | Accel, Menus
history(Config) | Opens history plugin configurations. | Accel, Menus
plugin(history, "Config"); plugin(history, "View"); | Same as previous descriptions. | Macros
INDEX

Hotlist Plugin | Function | Available in
hotlist() | Show hotlist in a menu list. | Menus
hotlist(Add) | Adds the page to the hotlist. | Accel, Menus, Toolbars
hotlist(AddLink) | Adds the selected link to the hotlist. | Menus
hotlist(Config) | Opens hotlist plugin configurations. | Accel, Menus, Toolbars
hotlist(Edit) | Opens the 'edit hotlist' window. | Accel, Menus, Toolbars
plugin(hotlist, "Edit"); plugin(hotlist, "AddLink"); $page = pluginmsgex(bookmarks, "FindNick", $nickname, STRING); | Same as previous descriptions. | Macros
INDEX

JSBridge Plugin | Function | Available in
- | JSBridge plugin can't be called. This is a plugin for K-Meleon kernel use only. | None

Privacy Plugin | Function | Available in
privacy(ClearCache) | Deletes disk cache. | Accel, Menus, Toolbars
privacy(ClearCookies) | Deletes the cookie file. | Accel, Menus, Toolbars
privacy(ClearHistory) | Deletes the history file. | Accel, Menus, Toolbars
privacy(ClearMRU) | Clears the URL bar dropdown list. | Accel, Menus, Toolbars
privacy(ClearSignon) | Deletes the passwords file. | Accel, Menus, Toolbars
plugin(privacy, "ClearCache"); plugin(privacy, "ClearCookies"); plugin(privacy, "ClearHistory"); plugin(privacy, "ClearMRU"); plugin(privacy, "ClearSignon"); | Same as previous descriptions. | Macros
INDEX

Rebarmenu Plugin | Function | Available in
rebarmenu(MenuName) | Generic syntax to popup a defined menu. | Accel, Toolbars
rebarmenu(&Web Search) | Popup Web Search menu. | Accel, Toolbars
rebarmenu(User Agent) | Popup User Agent menu. | Accel, Toolbars
rebarmenu(Privacy) | Popup Privacy menu. | Accel, Toolbars
rebarmenu(Compact Menu) | Popup Compact menu. | Accel, Toolbars
rebarmenu(T&abs) | Open tabs list menu. | Accel, Toolbars
plugin(rebarmenu, "MenuName"); | Show the popup menu. | Macros
INDEX

Sessions Plugin | Function | Available in
sessions(Config) | Opens sessions plugin configurations. | Accel, Menus, Toolbars
sessions(Save) | Save current session. | Accel, Menus, Toolbars
sessions(Undo) | Undo last closed tab/window. | Accel, Menus, Toolbars
plugin(sessions, "Config"); plugin(sessions, "Save"); plugin(sessions, "Undo"); | Same as previous descriptions. | Macros
INDEX

Toolbars Plugin | Function (available only in Macros)
$bChecked = pluginmsgex(toolbars, "IsButtonChecked", "<ToolbarName>, <ButtonID>", INT); |
$bEnabled = pluginmsgex(toolbars, "IsButtonEnabled", "<ToolbarName>, <ButtonID>", INT); |
pluginmsg(toolbars, "CheckButton", "<ToolbarName>, <ButtonID>, [0|1]"); |
pluginmsg(toolbars, "EnableButton", "<ToolbarName>, <ButtonID>, [0|1]"); |
pluginmsg(toolbars, "SetButtonImage", "<ToolbarName>, <ButtonID>, [HOT|COLD|DEAD], Path/to/new/image.bmp[0]"); |
pluginmsg(toolbars, "AddToolbar", ", <ButtonWidth>, <ButtonHeight>",""); |
pluginmsg(toolbars, "AddButton", "<ToolbarName>, <ButtonName>, <Command>, <MenuName>, <TooltipText>, <ButtonWidth>, <ButtonHeight>, hot.bmp[0], cold.bmp[0], dead.bmp[0]",""); |
Notes:

- Currently, buttons are identified by command, not by name. Consequently, must be replaced by the command associated to the button rather than the button's name.
- AddToolbar and AddButton can be used OnSetup only.

INDEX

Update Plugin | Function | Available in
- | This plugin check for K-Meleon updates at start K-Meleon. | None.

MACROS Plugin, some useful macros | Function | Available in Accel, Macros, Menus, Toolbars
macros(MACRO_NAME) | Generic syntax to call a macro. | Macro defined in file:
macros(Accel_Mouse([option])) | Apply the specified mouse accelerator configuration. Options: empty => K-Meleon defaults "Firefox 2.0" "SeaMonkey 1.1" "Opera 9.2" | Macro defined in file: accel.kmm
macros(cfg_FileNotFound) | Show a warning of a file not found. | Macro defined in file: cfg.kmm
macros(cfg_ProfileDir) | Open the profile directory. | Macro defined in file: cfg.kmm
macros(cfg_SettingsDir) | Open the settings directory. | Macro defined in file: cfg.kmm
macros(cfg_Macros) | Open the default macros directory. | Macro defined in file: cfg.kmm
macros(cfg_UserMacros) | Open the user macros directory. | Macro defined in file: cfg.kmm
macros(cfg_Commands) | View a list of commands available for menus, macros and toolbars. | Macro defined in file: cfg.kmm
macros(cfg_Skin) | Edit a skin configuration file. | Macro defined in file: cfg.kmm
macros(cfg_Settings) | Edit a configuration file. | Macro defined in file: cfg.kmm
macros(cfg_UserPrefs) | Edit a preferences file. | Macro defined in file: cfg.kmm
macros(cfg_UserStyle) | Edit a user style sheet. | Macro defined in file: cfg.kmm
MIGRATION COMPATIBILITY (only one execution is needed) | This macro is used to migrate K-Meleon profiles from versions 1.0 to 1.1 and from 1.1 to 1.5. It support the compatibility to Preferences, Groups/Sessions and Layer/Tabs. | Macro defined in file: compat.kmm
macros(Console2) | Open the enhanced error console. | Macro defined in file: console2.kmm
macros(DocInfo_Image) | View image properties. | Macro defined in file: docinfo.kmm
macros(DocInfo_Link) | View link properties. | Macro defined in file: docinfo.kmm
macros(DocInfo_Page_Links) | View all links in the current page. | Macro defined in file: docinfo.kmm
macros(DocInfo_Frame_Links) | View all links in the current frame. | Macro defined in file: docinfo.kmm
macros(DocInfo_Page_LinkedImages) | View all images linked by the current page. | Macro defined in file: docinfo.kmm
macros(DocInfo_Frame_LinkedImages) | View all images linked by the current frame. | Macro defined in file: docinfo.kmm
macros(DocInfo_Page_Images) | View all images in the current page. | Macro defined in file: docinfo.kmm
macros(DocInfo_Frame_Images) | View all images in the current frame. | Macro defined in file: docinfo.kmm
macros(domComplete(0)) | Complete the domain of URL bar text and go it. www.<URL>.com | Macro defined in file: domcomplete.kmm
macros(domComplete(1)) | Complete the domain of URL bar text and go it. www.<URL>.net | Macro defined in file: domcomplete.kmm
macros(domComplete(2)) | Complete the domain of URL bar text and go it. www.<URL>.org | Macro defined in file: domcomplete.kmm
macros(Encoding_AutoDetect([CHARSET])) | Apply the specified character set autodetection method. For CHARSET look in macro file. | Macro defined in file: encoding.kmm
macros(Encoding_ForceCharset([CHARSET])) | Force the specified character set encoding. For CHARSET look in macro file. | Macro defined in file: encoding.kmm
macros(hotlink(N)) => N=[0-9] | Open the specified hotlink. | Macro defined in file: hotlink.kmm
macros(IE_OpenPage) | Opens the current page in Internet Explorer. | Macro defined in file: ie.kmm (sendto.kmm)
macros(IE_OpenLink) | Open link in Internet Explorer. | Macro defined in file: ie.kmm (sendto.kmm)
macros(IE_OpenImage) | Open image in Internet Explorer. | Macro defined in file: ie.kmm (sendto.kmm)
macros(IE_OpenURL) | Opens the URL bar text in Internet Explorer. | Macro defined in file: ie.kmm (sendto.kmm)
macros(Mail_ConfigureMail) | Opens the dialog to configure your mail client. | Macro defined in file: mail.kmm
macros(Mail_ConfigureNews) | Opens the dialog to configure your news client. | Macro defined in file: mail.kmm
macros(Mail_ReadMail) | Opens your preferred email client. | Macro defined in file: mail.kmm
macros(Mail_ReadNews) | Opens your preferred news client. | Macro defined in file: mail.kmm
macros(Mail_ComposeMessage) | Opens your mail client. | Macro defined in file: mail.kmm
macros(Mail_SendPageURL) | Send a link to the current page by mail. | Macro defined in file: mail.kmm
macros(Mail_SendLinkURL) | Send the current link by mail. | Macro defined in file: mail.kmm
macros(Mail_SendImageURL) | Send a link to the current image by mail. | Macro defined in file: mail.kmm
macros(Mail_SendFrameURL) | Send a link to the current frame by mail. | Macro defined in file: mail.kmm
macros(Mail_SendSelection) | Send the selected text by mail. | Macro defined in file: mail.kmm
macros(mtypes) | Change file type settings. | Macro defined in file: mtypes.kmm
macros(NewsFox) | Open NewsFox for reading news feeds. | Macro defined in file: newsfox.kmm
macros(Proxy_None) | Connect directly to the Internet. | Macro defined in file: proxy.kmm
macros(Proxy_Auto) | Connect to the Internet over any detected proxy. | Macro defined in file: proxy.kmm
macros(Proxy_Custom([option])) | Connect to the Internet over the specified proxy. Options: proxyN => where N is a number from 1 to N proxies defined in Preferences kmeleon.plugins.macros.proxyN.name | Macro defined in file: proxy.kmm
macros(Reload_Continuously) | Continuously reload the current page. | Macro defined in file: reload.kmm
macros(Search) | Uses the default search engine to search for the selected text or URL bar text (if different from page URL). Otherwise, the search prompt will appear. | Macro defined in file: search.kmm
macros(Search_PasteAndSearch) | Search the Web for Clipboard contents. | Macro defined in file: search.kmm
macros(Search_ToggleEngineLock) | Lock or unlock the current search engine as the default engine. | Macro defined in file: search.kmm
macros(Search_Metasearch) | Search the Web using multiple engines. | Macro defined in file: search.kmm
macros(Search_KMForums) | Search the K-Meleon forums. | Macro defined in file: search.kmm
macros(Search_Engine([option])) | Search the Web using the specified engine. Options: N => number of search engine Look web search Preferences, kmeleon.plugins.macros.search.engine or search.xml file in your profile folder. | Macro defined in file: search.kmm
macros(Translate_From([option])) | Translate from the specified language. Options: xx => Where xx is a local language pair; en=english, es=spanish, ... | Macro defined in file: translate.kmm
macros(Translate_To([option])) | Translate to the specified language. Options: xx => Where xx is a local language pair; en=english, es=spanish, ... | Macro defined in file: translate.kmm
macros(Translate_ToggleRegion([option])) | Show languages from the specified region in the translation menu or not. Options: 0 => West European 1 => North European 2 => East European 3 => South European
4 => East Asian
5 => SE And SW Asian
6 => Middle Eastern
Macro defined in file: translate.kmm
macros(UserAgent([option])) | Set the specified User Agent string. Options: empty => K-Meleon default 1 => Firefox 2.0 2 => SeaMonkey 1.1 | Macro defined in file: useragent.kmm
macros(UserAgent_Custom) | Set a custom User Agent string. | Macro defined in file: useragent.kmm
macros(UserAgent_AlertString) | View the current User Agent string. | Macro defined in file: useragent.kmm
macros(UserAgent_ToggleReset) | Toggle resetting the default User Agent string when exiting. | Macro defined in file: useragent.kmm
macros(Zoom_In) | Perform the Zoom In button action. | Macro defined in file: zoom.kmm
macros(Zoom_Out) | Perform the Zoom Out button action. | Macro defined in file: zoom.kmm
macros(Zoom_Page_In) | Increases the size of images and text on the page. | Macro defined in file: zoom.kmm
macros(Zoom_Page_Out) | Decreases the size of images and text on the page. | Macro defined in file: zoom.kmm
macros(Zoom_Images_In) | Increases the size of images on the page. | Macro defined in file: zoom.kmm
macros(Zoom_Images_Out) | Decreases the size of images on the page. | Macro defined in file: zoom.kmm
macros(Zoom_Image_In) | Increase the size of the current image. | Macro defined in file: zoom.kmm
macros(Zoom_Image_Out) | Decrease the size of the current image. | Macro defined in file: zoom.kmm
macros(Zoom_Page) | Let zoom buttons effect text and images. | Macro defined in file: zoom.kmm
macros(Zoom_Text) | Let zoom buttons effect text only. | Macro defined in file: zoom.kmm
macros(Zoom_Images) | Let zoom buttons effect images only. | Macro defined in file: zoom.kmm
MAIN MACROS, some useful macros | Function | Available in Accel, Macros, Menus, Toolbars
- Events strings: $OnInit $OnSetup $OnStartup $OnOpenWindow
$OnOpenTab
$OnLoad
$OnLoadOnce
$OnActivateWindow
$OnCloseWindow
$OnCloseTab
$OnCloseGroup
$OnWMAppExit
$OnQuit
Append any macro to be executed On[event] to the appropriate string (semicolon-separated lists ';').
Macro defined in file: main.kmm
- Macro modules string: $macroModules | Append any installed module's name to this string (semicolon-separated list ';'). | Macro defined in file: main.kmm
- Plugins presence: $kBookmarks $kFavorites $kFullscreen $kHistory
$kHotlist
$kLayers
$kLayersOnly
$kPrivacy
$kRebarmenu
$kSessions
$kToolbars
$kTabs
Use these global vars to determine the presence of a plugin.
Do not read kmeleon.plugins.?.load at runtime! (The pref may be false although the plugin is currently loaded or vice versa.
Macro defined in file: main.kmm
macros(kTabs_Detach) | Detach this tab from the current window. | Macro defined in file: main.kmm
macros(kTabs_ReloadAll) | Reload all tabs in the current window. | Macro defined in file: main.kmm
macros(kPrivacy_ClearAll) | Deletes all your privacy data: cache, cookies, history, URL bar history and passwords. | Macro defined in file: main.kmm
macros(kmPrefs([section])) | Change preferences and settings. | Macro defined in file: main.kmm
- Use for text files: (Open) macros(getExtensionHandler) - Use for script files: (Edit) macros(getSecureExtensionHandler) | These macros can be used in conjunction with the exec() and promptforfile() statements to get a command line and a file type description for a given file extension. | Macro defined in file: main.kmm
- To open URLs: macros(OpenURL) macros(OpenURL_InBg) macros(OpenURL_InNew) macros(OpenURL_InNewWindow)
macros(OpenURL_Selected)
macros(OpenURL_Typed)
Except OpenURL these macros can only be called by other macros, because macro function caller must previously define the variable $OpenURL with the URL to open.
Prompt for an URL to open.
Same as OpenURL_InNew, but in background.
Open an URL in a new tab if tabs are enabled, in a new window otherwise.
Open an URL in a new window.
Use this method when an URL was generated from selected text.
Use this method when an URL was generated from a direct user input (by typing into URL Bar or any prompt).
Macro defined in file: main.kmm
- Mozilla Chrome: macros(moz_AboutCache_Image) macros(moz_AboutCache) macros(moz_AboutConfig) macros(moz_JSConsole)
macros(moz_CertificateViewer)
View cache information.
View information about the Cache Service.
View the browser configuration page
Open the error console
View stored certificates
Macro defined in file: main.kmm
- Paths to Privacy Preferences: $pref_Animation $pref_Colors $pref_Cookies $pref_Frames
$pref_Images
$pref_Java
$pref_JavaScript
$pref_Popups
$pref_Referer
To use with getpref(TYPE,[preference]).
Macro defined in file: main.kmm
$pref_JavaSupport | Use this global var to determine whether Java can be enabled at runtime. | Macro defined in file: main.kmm
macros(pref_ToggleAnimation) | Toggle image animation. | Macro defined in file: main.kmm
macros(pref_ToggleColors) | Toggle page colors. | Macro defined in file: main.kmm
macros(pref_ToggleCookies) | Toggle cookie acceptance. | Macro defined in file: main.kmm
macros(pref_ToggleFrames) | Toggle frame support. | Macro defined in file: main.kmm
macros(pref_ToggleImages) | Toggle image loading. | Macro defined in file: main.kmm
macros(pref_ToggleJava) | Toggle Java support. | Macro defined in file: main.kmm
macros(pref_ToggleJavaScript) | Toggle JavaScript execution. | Macro defined in file: main.kmm
macros(pref_TogglePopups) | Toggle popup blocking. | Macro defined in file: main.kmm
macros(pref_ToggleReferer) | Toggle HTTP referer transmission. | Macro defined in file: main.kmm
- Type Ahead Find (Page Search): $_pref_TAF macros(pref_ToggleTAF) macros(pref_ToggleTAFAuto) macros(pref_ToggleTAFLinks)
Path to Preference.
Toggle Find As You Type.
Toggle Find As You Type Autostart.
Toggle Find As You Type in links only.
Macro defined in file: main.kmm
- K-Meleon Preferences: $KM_Version $KM_Flashblock $KM_Adblock | K-Meleon version. Path to Flashblock preference. Path to Adblock preference. | Macro defined in file: main.kmm
macros(KM_ToggleFlashblock) | Toggle Flashblock. | Macro defined in file: main.kmm
macros(KM_ToggleAdblock) | Toggle Ad-Blocking StyleSheet. | Macro defined in file: main.kmm
- Homepage preferences: $KM_Homepage $KM_HomeSess $KM_StartHome $KM_StartSess | Path to Homepage preference. Path to Home Session preference. Path to Start Home preference. Path to Start Session preference. | Macro defined in file: main.kmm
macros(KM_SetAsHomepage) | Set the current page as the Home page. | Macro defined in file: main.kmm
macros(KM_StartBlank) | Let K-Meleon start with a blank page. | Macro defined in file: main.kmm
macros(KM_StartWithHomepage) | Let K-Meleon start with the Home page. | Macro defined in file: main.kmm
macros(KM_StartWithSession) | Let K-Meleon start with a saved session. | Macro defined in file: main.kmm
- JavaScript Document Handling: $JS_doit $JS_func $JS_last $JS_fail | Parameters for JS_hndlDoc(s) (set those you need before calling the macro): Takes the code to be executed in the context of each frame. Is the right place for functions and global variables (e.g. when you want to count something over all frames)
Is the right place for finishing actions (e.g. when you want to alert what you have counted over all frames)
Is the right place to handle errors that may occur when accessing a frame (Gecko prevents cross-site scripting)
Macro defined in file: main.kmm
macros(JS_hndlDocs) | To inject JS in each frame. | Macro defined in file: main.kmm
macros(JS_hndlDoc) | Same as JS_hndlDocs, but only for the current frame. | Macro defined in file: main.kmm
macros(JS_hndlTop) | Same as JS_hndlDoc, but only for the topmost frame (to avoid cross site scripting). | Macro defined in file: main.kmm
- JavaScript Image Handling: $JS_doitImage $JS_doitInput | Parameters for JS_hndlImage (set those you need before calling the macro): Takes the code to be executed in the context of all matching images in the current frame. Takes the code to be executed in the context of all matching image-type input elements in the current frame | Macro defined in file: main.kmm
macros(JS_hndlImage) | To inject JS for images. | Macro defined in file: main.kmm
- Parameter for JS_hndlLink: $JS_doitLink | Parameters for JS_hndlLink (set this you need before calling the macro): Takes the code to be executed in the context of all matching links in the current frame. | Macro defined in file: main.kmm
macros(JS_hndlLink) | To inject JS in all matching links in the current frame. | Macro defined in file: main.kmm
macros(JS_reloadFrame) | Reload the current frame. | Macro defined in file: main.kmm
macros(JS_reloadImage) | Reload the current image. | Macro defined in file: main.kmm
macros(JS_killApplets) | Erase all Java applets in the current page. | Macro defined in file: main.kmm
macros(JS_killFlash) | Erase all Flash objects in the current page. | Macro defined in file: main.kmm
macros(JS_scrollTop) | Scroll to the top of the current page. | Macro defined in file: main.kmm
macros(JS_scrollBottom) | Scroll to the bottom of the current page. | Macro defined in file: main.kmm
macros(JS_scrollLeft) | Scroll to the left end of the current page. | Macro defined in file: main.kmm
macros(JS_scrollRight) | Scroll to the right end of the current page. | Macro defined in file: main.kmm
macros(Go_Copy) | Copy URL Bar contents to the Clipboard. | Macro defined in file: main.kmm
macros(Go_New) | Open URL Bar contents in a new page. | Macro defined in file: main.kmm
macros(Go_Paste) | Open Clipboard contents as URL. | Macro defined in file: main.kmm
macros(Go_Reset) | Reset the URL Bar. | Macro defined in file: main.kmm
macros(Go_Selected) | Open the selected text as URL or open URL Bar contents. | Macro defined in file: main.kmm
macros(Go_Top) | Go to the topmost directory level of the current domain. | Macro defined in file: main.kmm
macros(Go_Up) | Go up one directory level in the current domain. | Macro defined in file: main.kmm
macros(Home) | Perform the Home button action. | Macro defined in file: main.kmm
macros(RSS) | Perform the RSS button action. | Macro defined in file: main.kmm
macros(Open_TextAsURL) | Open the selected text as URL. | Macro defined in file: main.kmm
macros(Open_KMReadme) | View basic information on the K-Meleon project. | Macro defined in file: main.kmm
macros(Open_KMWiki) | Go to the K-Meleon Wiki. | Macro defined in file: main.kmm
macros(ExecMacros_Frames) | Execute one or more macros if frame support is granted. Parameters (set before calling): $ExecMacros = The macros to be executed (semicolon-separated list ';'). | Macro defined in file: main.kmm
macros(ExecMacros_JavaScript) | Execute one or more macros if JavaScript execution is granted. Parameters (set before calling): $ExecMacros = The macros to be executed (semicolon-separated list ';'). | Macro defined in file: main.kmm
macros(ExecMacros_Popups) | Execute one or more macros overriding any restriction in regard to popup windows. Parameters (set before calling): $ExecMacros = The macros to be executed (semicolon-separated list ';'). $ForceTab = Force popups into tabs (true or false). | Macro defined in file: main.kmm
macros(ExecMacros_List) | Execute one or more macros for each item of a semicolon-separated list (;). Parameters (set before calling): $ExecMacros = The macros to be executed (semicolon-separated list ';'). $List = The list to be processed ("[string1];[string2];...;[stringN];" or an empty string).
Output (for use in your macros):
$ListItem = The current substring [stringM].
Macro defined in file: main.kmm
INDEX

######

More info about this in K-Meleon Documentation online.

## K-Meleon's Profile

### Location

Since version 1.0, K-Meleon is storing its profiles in your Application Data (%AppData%) directory by default. This is to ensure that K-Meleon has the necessary privileges to write to its profile directory on modern NT-based Windows operating systems (NT/2000/XP/Vista) which are the most common today. The location of the %AppData% directory depends on your specific Windows version. In case of doubt, you can always open your current profile directory from out of K-Meleon (choose Edit > Configuration > Profile Directory).

To set a different location for your profiles, you have the following possibilities:

#### Set the profile location through a profile.ini file:

When installing K-Meleon using the setup program, you are given the possibility to locate your profiles in the K-Meleon installation directory (which is the classic behavior) instead of the %AppData% directory. When you are asked to select the components to install, simply uncheck the option "Multi-user Profiles". The setup program will then create a file called profile.ini (which is a simple text file) in your K-Meleon installation directory (where k-meleon.exe resides). By default, profile.ini has the following contents (an empty profile.ini has the same effect):

    [profile]
    path=Profiles
    isRelative=1

The value of the variable path specifies the location of the folder which contains your profiles. If the variable isRelative is set to 1, the value of path is taken relative to the K-Meleon installation directory. In the above case, your profiles will be located in subfolder Profiles of the K-Meleon installation directory. Otherwise, if isRelative is set to 0, the value of path must be a fully qualified path.

#### Set the profile location through the -profilesDir command line switch:

This switch overrides profile.ini. See command line options.

### Profile Advanced Location

K-Meleon 1.5.x has a new profile component (similar to the one of Firefox - or it even is the one of Firefox). In K-Meleon 1.5 the file profiles.ini is the profile pointer. In previous versions the file registry.dat is the profile pointer. The purpose of the profile pointer is to tell the browser what profiles exist and where they are located. In order to move or rename profile directories, just edit profiles.ini (registry.dat is synchronized automatically).

The profile.ini file that can be placed in the K-Meleon installation directory, is just a pointer to the profile pointer - it tells K-Meleon where to look for the actual profile pointer (profiles.ini or registry.dat).

One of the advantages of the new system is portability. In order to get a portable installation of K-Meleon 1.5, you just need to uncheck the option "Multi-user profiles" when installing (or manually place a profile.ini in the installation directory). You can then just copy the installation directory to a USB stick - the installation will work whatever drive letter the stick may get.

If you like more info about this you can read this online Mozilla documentation.

### Migrating Profiles

By using an old profile with a new version of K-Meleon you might miss some of the new features. Compare your profile files with those available in C:\Program Files\K-Meleon\defaults\profile\ and do the needed adjustments.
For migrating from K-Meleon 0.7 to K-Meleon 0.8 these new features include LButton, MButton and RButton in accel.cfg, and DocumentImagePopup and FrameDocumentImagePopup in menus.cfg.

#### Backup your old K-Meleon profile

The profile files are normally located in:

    C:\Program Files\K-Meleon\Profiles\[your name]\!!!!!!!!.slt

The following files can be backed up to tranfer your profile to a new install of K-Meleon. Do not try to transfer any other files. (and never mind if your profile doesn't have all of these files)

- accel.cfg
  * Configuration file for keyboard accelerators (shortcuts)
- bookmarks.html
  * A Hypertext document containing your saved bookmarks.
- cookperm.txt
  * Your cookie permissions file.
- macros.cfg
  * Configuration file for macros
- menus.cfg
  * Configuration file for the browser menus. These define the order and text displayed for all menus
- opera.adr
  * A text file containing your saved hotlist.
- Prefs.js
  * Preference file edited through the preference dialog (or about:config). * WARNING - It is best not to tranfer the complete file. Copy into user.js the preferences you want to keep. Do not transfer prefs which reference your old profile.
- User.js
  * User preference file which overrides the Prefs.js file.

#### Other files that you should consider saving.

- K-Meleon\Profiles\[your name]\!!!!!!!!.slt\Chrome\userContent.css
  * This is a Cascading Style Sheet that controls K-Meleon's display content
- K-Meleon\Skins\[downloaded skins]
  * Save any downloaded skins that you may have in this folder.
- K-Meleon\plugins\[added plugins]
  * Backup any extra plugins you may have added.

#### Installing your new K-Meleon

1. Save the above files in a safe place.
2. Uninstall K-Meleon.
3. Ensure that the directory C:\Progam Files\K-Meleon is either empty or deleted.
4. Install K-Meleon and make your choice of options to include.
5. Start K-Meleon in the default profile. Go to Edit > Manage Profiles > New > [your name] > check Ask At Startup > OK
6. Close K-Meleon and open your file manager.
7. Copy your saved profile files into their respective directories.
8. Restart K-Meleon, selecting the new profile. If all went well, your are now enjoying you newly updated K-Meleon.

## Links to Online Documentation

K-Meleon FAQ

K-Meleon Configuration Files

K-Meleon 1.x Reference by kko

Macro Guidelines to do macro codes

Macro Language Documentation

Macro Language Documentation rearranged and completed by JamesD

Macro Language Documentation by kko

Extension Setup 1.9.0 for K-Meleon 1.1 by JujuLand

K-Meleon Extensions

Unofficial K-Meleon Distributions

Online version of this file

Before version to 1.5.X

Check for updates and more recent version

UP