1

X-Mouse Button Control

User Guide
X-Mouse Button Control is a Windows application for remapping your mouse buttons. It is not a
driver for pointing devices, but rather works in conjunction with the installed drivers. For a long
time XMBC has supported binding buttons to an individual process and now includes binding to
specific window parts. XMBC is not strictly for button mapping, various navigation customizations
are available; tuning the pointer and scroll wheel to your likes.

To access the setup dialog double-click the XMBC icon

in the notification area or run the program from the
start menu. The tray icon may be automatically hidden on Windows 7,
drag the XMBC icon from the hidden section over to the area next to the
clock and it will show permanently.
 2

Profile List and Information

Configure applications to suit your individual needs

The list of profiles assigned to various applications and/or windows. From here you can activate/deactivate profiles, rename profiles,
create new profiles, copy an existing profile, edit/change the assigned object, import/export profile(s) or remove an unnecessary profile.
Profiles can be edited, copied or removed via their respective buttons or from the right-click context menu. If a profile’s text is RED,
then it is the active profile, in other words it currently has keyboard/mouse focus for sending commands.

The Profile Information box displays how XMBC identifies the selected process and/or window.
The information is identical to what is chosen/entered in either the
Choose Application or Find Window dialog.

Importing and Exporting Profiles

Accessible from the context menu only.

The X-Mouse Button Control registered file type, .xmbcs, is used to save
exported profiles.

By default profiles are saved to the current user’s %APPDATA% directory

under ‘Highresolution Enterprises’. Save exported profiles wherever is
suitable; the new save location will be remembered.

A batch export is also available for easily backing up the settings of every
single profile in a single .xmbcs file.

An exported file may be opened, double-click to import the contained

profiles into XMBC. If there is a conflict with a current profile you will be
prompted to overwrite the existing one, discard the inserting entry or
cancel the entire import process.
 3

Selecting an Application and/or Window

Adding a Process Profile

Pressing the Add or Copy buttons will bring up a

dialog box listing all currently running applications.

Choose from the list of running applications,

browse for an EXE, manually enter a process
name, or opt to use a specific window.
The description field is used to give a profile a
custom display name in the profile list.

Adding a Window Specific Profile

After choosing Specific Window from within the running

applications dialog, the Find Window dialog will appear
allowing for more specific identification.

For target selection press and hold left the left-click button
over the window finder icon then drag the target cursor to
the desired window and release.

For hover selection mark the radio button then move the
cursor over the desired window. Press caps lock to stop
hot-tracking so the current window’s information can be
confirmed in the dialog box.
 4

Multi-Layered Button Mapping

Providing 5 layers of button mapping for e very profile

Complete list of Mapping Commands, available on each of the 9 controls

You can re-bind up to 9 controls (Left Button, Right Button, Middle/Wheel

Button, XButton1/Button4, XButton2/Button5, Wheel Up, Wheel Down,
Tilt Wheel Left and Tilt Wheel Right) on each and any of the five layers.

The orange-yellow highlight indicates XMBC is currently receiving a

standard Windows message from that control, in other words you are
currently manipulating it. If no highlight is seen when manipulating a
control, then its current message is not compatible with X-Mouse Button
Control.

Any of the five layers can be given a custom name on each and every
profile. This name will be displayed in a balloon notification when
switching layers (notification is optional).

The reset button in the upper right corner can be used to revert all
controls on the current layer to default.

NOTE: Only Microsoft’s post-XP operating systems support standard tilt

wheel messages. Tilt Wheel Left & Tilt Wheel Right will not be available
on Windows XP or previous operating systems.
 5

Scrolling & Navigation Adjustment

The right-most tab, providing advanced pointer & scroll wheel adjustments

POINTER
Currently only a single pointer adjustment is available on a per profile basis.
‘Axis Locking’
Axis locking prevents pointer movement along either the X or Y axis.
Each of the axes needs an assigned hotkey for activation.

SCROLL WHEEL
Many scroll wheel enhancements are available. Inverting the vertical scroll
directions, page scrolling and adjusting the default number of lines to scroll
are just the beginning. Several scroll methods are also available in the
Advanced Window Scrolling section (it is possible to use negative scrolling
increments, though only Method 4 processes them).
 6

Special Assignments
Advanced Scrolling Methods
There are currently 4 methods from which to choose (not including disabled of default). A window needs to be selected in order to assign these
to a profile, choosing a process alone won’t do. To reverse scrolling choose a negative increment.

1. Scroll Message – send WM_HSCROLL or WM_VSCROLL directly to the window under the mouse. (works with some windows)
2. Scroll Info – the Win32 API to set the scroll position of a window... (rarely works, but gives great results when it does)
3. Left/Right Keys – sends left/right simulated keystrokes (only applies to horizontal scrolling)
4. Wheel Message – send WM_MOUSEWHEEL or WM_MOUSEHWHEEL message to the window (most recognizable/reliable)

Default passes through the original uninterrupted message sent by the mouse’ driver.

Disabled blocks the original message and doesn’t inject anything other messages.

NOTE: When any of the first three methods fails to register for an application XMBC evokes the ‘Default’ scrolling method and applies the
vertical lines or horizontal characters scrolling increments, ‘Method 3’ will resort to ‘Method 1’ for vertical scrolls prior to evoking ‘Default’. This
way scrolling will not cease if one of these methods isn’t recognized by the window.

Simulated Keystroke Assignments

From this dialog you can assign various keystrokes
and/or hotkeys through your mouse.

There are 8 methods available for sending your

assigned keystroke.

Pressed – sent upon pressing the button

Released – sent upon releasing the button

During – maintained while the button is held

[like holding down keys on the keyboard, minus repetition]

Threaded Press – on press in another thread

[recommended when using {WAIT…} in a key sequence]

Threaded Release – on release in another thread

[recommended when using {WAIT…} in a key sequence]

Repeatedly – continuously sends while held

[like repeatedly pressing keys on the keyboard]

Sticky Repeat – a ‘Repeatedly’ toggle

[press once to begin repetition, press again to cease]

Sticky Hold – a ‘During’ toggle

[press once to activate, again to deactivate]

Using a repeat method supports the option to set a

custom repeat interval between the collective keys.
{0ms passes through the control panel’s settings}

Marking ‘only send if profile’s process is active’ will only send keys when the appropriate window is given focus.
{on by default, not recommended for sending hotkeys}
 7

Advanced Settings - General

In order for any of the below settings to take effect, you must OK the changes then press apply in the main dialog.

General Settings
These options are applied globally (none are profile specific).

 Mouse Speed – adjusts the rate of pointer movement in relation

to physical manipulation of the mouse
 …scroll window under cursor – sends scrolling messages to the
window/control directly beneath the mouse pointer, as opposed
to the one with keyboard focus
 Bypass ALL actions when SCROLL LOCK is ON – disables all of
XMBC’s settings when the keyboard’s Scroll Lock is activated
 Bypass 'disabled' actions when SCROLL LOCK is ON – re-enables
all disabled settings when the Scroll Lock key is activated;
cannot be used when all actions are bypassed by Scroll Lock
activation
 Process non-client mouse messages – if disabled XMBC will
ignore mouse messages sent to the titlebar area of a window
(DISABLING can degrade performance and is NOT
RECOMMENDED)
 Swap 4th and 5th buttons – swaps the side buttons on most mice
(mouse buttons 4/5)
 Swap 4th and 5th buttons… remote desktop – swaps the side
buttons only while the user is connected to a remote desktop
session (affects XMBC on the remote machine)
 Reset sticky buttons… – clears any assigned sticky buttons’
pushed down state whenever another button is pressed
 Show layer switch balloon notifications – toggles balloon tip
notification above the notification area when switching layers
using a hotkey or button assignment
 Show tray icon by default – whether or not the XMBC icon is
displayed in the notification area after log on (to display the icon again simply re-run the executable, it won’t run multiple processes
of the program just instruct the icon to appear in the system tray)
 Ignore Num Lock state for Simulated Keystrokes – always treats the number pad on the keyboard as if Num Lock were disabled,
when sending simulated keystrokes
 Fix-up tilt wheel auto-repeat – this option can be adjusted to clean up unseemly message repetition from tilt wheels
 Enable profile switching on mouse move – allows XMBC profiles to be activated when the mouse pointer is over the identified
object, as opposed to only when the cursor is activated (requires SLIGHTLY more resources)
 Check for new version at startup – a version check will be performed on the first of every month and upon first run
 Enable debug logging – activates XMBC’s debug mode, it is useful when reporting issues to the developer. The debug log is saved in
the current user’s %APPDATA% directory under ‘Highresolution Enterprises’ by default and may be accessed from the system tray.
(debug logging is very resource intensive and will hinder mouse responsiveness, as such the setting is not persistent and will be
disabled on any subsequent launches)
 8

Advanced Settings - Hotkeys

Global Hotkeys
The hotkeys assigned in this tab have a system-wide effect; make
sure they aren’t already in use somewhere else. These hotkeys will
activate their relevant setting; in some cases using the hotkey
again will toggle/cycle the setting.

Modifier Keys
These hotkeys work as instant toggles. Their relevant settings are
only applied while the hotkey is held down. They are system-wide,
so make sure there are no conflicts.
 9

Further Configurations
Using Layered Button Mapping
There are 5 fully customizable layers that may be put to use in XMBC. Several methods are available for activating layers.

Global Hotkeys
Assign hotkeys to the desired layers. Sending this hotkey will perform a rigid layer switch, not reverting back to your previous layer or
switching to any other layers until another command to switch layers is received.

Modifier Keys
Assign a modifier key for activating the desired layer. Pressing and holding this hotkey will temporarily activate the layer, reverting to
the previously active layer once the hotkey is released.

Button Assignment
Every layer supports mapping buttons to layers other than itself. But assignments work just like modifier keys, activating a layer only
while held. Once a button has been mapped to an alternate layer the button on the subsequent layer will be marked as layer revert and
cannot perform any other functions on that layer.

Context Menu
Layers can also be manually chosen from the context menu by right-clicking the icon in the notification area.

NOTE: It is not recommended to attempt chaining layer switching through use of the modifier key or button assignment methods. Activating a
layer by holding a button/modifier followed by using yet another button/modifier on the resulting layer can & will lead to confusion in certain
circumstances.

Locking Axes
In order to lock either the X or Y axis it is first necessary to setup the corresponding hotkey or modifier key and enable axis locking on a per
profile basis.

Global Hotkeys
Go to the ‘Scrolling & Navigation’ tab and mark ‘Enable axis locking modifier keys’ on the desired profile, then use the assigned global
hotkey to enable/disable axis locking for the specified axis.

Modifier Keys
Choose the ‘Scrolling & Navigation’ tab and mark ‘Enable axis locking modifier keys’ for the desired profile, now pressing and holding the
relevant modifier key will toggle axis locking.

NOTE: Axis Locking works by preventing any movement on the chosen axis. So locking the X-Axis will PREVENT the cursor from moving along
the X-Axis, not RESTRICT cursor movement to only along the X-Axis.

Changing the Tray Icon

Use your own icons by placing ICO files in the same folder as the main executable (XMouseButtonControl.exe). A unique icon can be used to
represent each of the 5 layers and the disabled state. Create or download icon files using 16x16 and/or 32x32 (auto-resized) dimensions. The
following naming pattern is necessary in order for the .ico files to be accepted by XMBC. Exit and re-launch the program to load the icons.

Layer1.ico (the default icon), Layer2.ico, Layer3.ico, Layer4.ico, Layer5.ico, and Disabled.ico

X-Mouse Button Control @ Highrez Forums

Download X-Mouse Button Control

X-Mouse Button Control Author: Phillip Gibbons X-Mouse Button Control Documentation: MainTrane