intellimouse-ctl

A cross-platform command line tool and library for Microsoft's IntelliMouse devices.

It supports the following models:

• Pro IntelliMouse (2019)
• Classic IntelliMouse (2017)

Usage

CLI

intellimouse-ctl --help
usage: intellimouse-ctl [-h] [--json] {get,set,list} ...
positional arguments:
{get,set,list}
get get the value of a setting
setset the value of a setting
list lists the connected devices and their indices
options:
-h, --help show this help message and exit
--json output JSON

Commands passed to a device that doesn't support the given commands will ignore them.

Library

fromintellimouseimportClassicIntelliMousefromintellimouseimportProIntelliMousewithClassicIntelliMouse.enumerate()[0] asmouse:
print(mouse)
withProIntelliMouse.enumerate()[0] asmouse:
print(mouse)

Features

Pro IntelliMouse

• DPI
• LOD
• LED
• Polling Rate
• Custom Button Mapping
• Custom LOD Calibration

Classic IntelliMouse

• DPI
• Custom Button Mapping

Install

PyPI

pip install intellimouse-ctl

Local

git clone https://github.com/k-visscher/intellimouse-ctl.git
cd intellimouse-ctl
pip install .

Gentoo Linux

layman -fa fol4 (or eselect repository enable fol4)
emerge -av intellimouse-ctl

Development

To set up a virtual environment to further develop this tool/library, use the following commands:

python -m venv venv
source venv/bin/activate
pip install --editable .

Documentation

View

pdoc ./src/intellimouse/

or view it over at:

https://intellimouse.visscher.codes

Generate

pdoc ./src/intellimouse/ -o ./docs

Sponsors

• @madsl for donating the Classic IntelliMouse to this project.

License

This application is licensed under the the MIT license.

Disclaimer

All company, product and service names used in this project are for identification purposes only.
Use of these names, trademarks and brands does not imply endorsement.
In no way is this project published by, affiliated with, or sponsorsed, or endorsed, or approved by Microsoft.

All product names, trademarks and registered trademarks are property of their respective owners.
Microsoft Pro IntelliMouse is a registered trademark or trademark of Microsoft Corporation in the United States and/or other countries.
Microsoft Classic IntelliMouse is a registered trademark or trademark of Microsoft Corporation in the United States and/or other countries.
All other trademarks cited herein are the property of their respective owners.