Mouse Gestures speed up browsing by assigning shortcuts to quick mouse movements. It is as simple as right-clicking while sliding your mouse left or right. Make a quick sweep left while right-clicking to navigate back to the previous page. Or move your mouse to the right while right-clicking for forward navigation. Of course, this is not all this feature can do. K-Meleon gives you the ability to customize and create your own functions.

Preferences

K-Meleon supports mouse gestures through a native Kplugin. To enable mouse gestures:

1. Go to Edit > Preferences (F2) >> K-Meleon Plugins > Mouse Gestures in K-Meleon's menu.
2. Click the Enable Mouse Gestures checkbox at the top of the page.

You can view the default gestures and create custom gestures in the preferences menu. These changes will be added automatically to the prefs.js file in your profile folder. If you migrate your profile to a new installation the settings will transfer over. If you want to make sure a setting does not change you can copy and paste it from prefs.js to user.js. You can also create gestures manually using the syntax below.

User.js

Default Preferences

The gestures Kplugin creates a set of default gestures. The most 2 most common gestures are explicitly added to your preferences visible on the about:config page and your prefs.js file. The plugin maps the back button to movement left and the forward button to movement right because these are the most commonly used gestures. After activating the plugin you will see the following lines in K-Meleon/Profiles/<your.profile>/pref.js unless you have an alternative default defined in user.js:

user_pref("kmeleon.plugins.gestures.LR", "ID_NAV_FORWARD");
user_pref("kmeleon.plugins.gestures.RL", "ID_NAV_BACK");

Customizable Preferences

You can create custom preferences in user.js or pref.js using the syntax below. If you change settings in the preferences menu these will be added automatically to the pref.js file in your profile.

user_pref("kmeleon.plugins.gestures.down", "[macro/commandID/pluginMsg]");
user_pref("kmeleon.plugins.gestures.downleft", "[macro/commandID/pluginMsg]");
user_pref("kmeleon.plugins.gestures.downright", "[macro/commandID/pluginMsg]");
user_pref("kmeleon.plugins.gestures.up", "[macro/commandID/pluginMsg]");
user_pref("kmeleon.plugins.gestures.upleft", "[macro/commandID/pluginMsg]");
user_pref("kmeleon.plugins.gestures.upright", "[macro/commandID/pluginMsg]");
user_pref("kmeleon.plugins.gestures.mindist", "[pixels]");
user_pref("kmeleon.plugins.gestures.split", "[percent]");
user_pref("kmeleon.plugins.gestures.maxslip", "[percent]");
user_pref("kmeleon.plugins.gestures.maxtime", "[milliseconds]");

Movements less than "mindist" are normal clicks. The "split" tells how big a slice of the pie to give for the axes (100% = only axes, no diagonals; 0% = no axes only diagonals). With "maxslip" you can set how sloppy you may draw (0% = not a pixel wrong; 100% = always produces a direction). After "maxtime" milliseconds the gesture times out and you get a normal click.

Customizable Preferences

You can create actions that depend on whether Shift, Control, or Alt is pressed; whether the Left, Middle, or Right mouse buttons is used; and whether you click on an Image or Link or not. (left and middle mouse buttons require at least one of shift, control, or alt)
Add one or more of [S,C,A] and [L,M,R] before the direction (in that order) and one, two or none of [L,I] (in that order) after the direction to get the preference name. Use "nomove" for simple clicks.

user_pref("kmeleon.plugins.gestures.[S,C,A][L,M,R][Direction][L,I]",
              "[macro/commandID/pluginMsg]");

[Direction] : up, down, left, right, upleft, upright, downleft, downright, nomove

Examples

user_pref("kmeleon.plugins.gestures.upleft", "layers(Open)");
user_pref("kmeleon.plugins.gestures.up", "ID_NAV_HOME");

# workaround for bug 547
user_pref("kmeleon.plugins.gestures.SLnomoveI", "ID_SAVE_IMAGE_AS");
user_pref("kmeleon.plugins.gestures.SLnomoveLI", "ID_SAVE_IMAGE_AS");

# gestures like StrokeIt for KM
user_pref("kmeleon.plugins.gestures.RdownL", "ID_OPEN_LINK_IN_NEW_WINDOW");
user_pref("kmeleon.plugins.gestures.RdownrightL", "ID_OPEN_LINK_IN_BACKGROUND");

user_pref("kmeleon.plugins.gestures.SRdownL", "layers(OpenLink)");
user_pref("kmeleon.plugins.gestures.SRdownrightL", "layers(OpenLinkBg)");

Touchpads and multi-touch

Windows 10 and up support multi-touch gestures for touchscreens and capacitive touchpads natively. Windows gestures will work in K-Meleon but cannot be customized. Some Windows gestures will override K-Meleon gestures.

• Two-finger tap: This pulls up the right-click menu. It does not function as a right-click for K-Meleon gestures. If your touchpad has a physical right-click button, this will work with K-Meleon.
• Two-finger slide: Two-finger slides will scroll the page up or down. It will override directional commands in the gestures plugin. One-finger slides will work with all K-Meleon gestures.
• Pinch: This will zoom the page out. Slide your fingers apart to zoom the page in. No commands from the K-Meleon plugin will activate while zooming in or out.