Installation

System Requirements

3D Slicer: Version 5.0 or later (5.4+ recommended)
Python: 3.9+ (included with Slicer)
Operating System: Windows, macOS, or Linux
Mouse: Any mouse works; multi-button mice get the most benefit

From Extension Manager (Recommended)

Open 3D Slicer
Go to View > Extension Manager
Search for “MouseMaster”
Click Install
Restart Slicer when prompted

The extension will be available in Modules > Utilities > MouseMaster.

From Source (Development)

For developers or if you want the latest unreleased features:

git clone https://github.com/benzwick/SlicerMouseMaster.git

Then add the module to Slicer:

Open 3D Slicer
Go to Edit > Application Settings > Modules
Add the path to SlicerMouseMaster/MouseMaster to Additional module paths
Restart Slicer

Verifying Installation

After installation:

Open the module selector dropdown
Navigate to Utilities > MouseMaster
The MouseMaster panel should appear

If you see an error, check the Troubleshooting guide.

Updating

From Extension Manager:

Open View > Extension Manager
Go to the Installed tab
Click Update next to MouseMaster if available
Restart Slicer

From Source:

cd SlicerMouseMaster
git pull origin main

Then reload the module in Slicer.