detect-buttons

Detect unknown mouse button mappings in Slicer via a Python console workflow.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/benzwick/SlicerMouseMaster --skill detect-buttons
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: detect-buttons
Source: https://github.com/benzwick/SlicerMouseMaster/tree/main/.claude/skills/detect-buttons
Command: npx skills add https://github.com/benzwick/SlicerMouseMaster --skill detect-buttons

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detect unknown mouse button mappings within Slicer by guiding the user through a button-detection workflow using the Slicer Python console.

Core Features & Use Cases

  • Provides a guided process to run a Qt-based button detector, print codes on press, and collect mapping results.
  • Helps create a new mouse profile by translating codes to actions, enabling future use in Slicer modules.
  • Suitable for users with non-standard mice or drivers that remap buttons across Windows, macOS, and Linux.

Quick Start

Run the provided button-detection workflow in Slicer to map each physical button to its Qt code and save the results to a new mouse profile.

Frequently Asked Questions about detect-buttons

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify unknown mouse button mappings in Slicer?

You detect unknown mouse buttons in Slicer by running a provided Qt event-filter script in the Slicer Python console. The script captures and prints Qt button codes on press, which you record to build a custom mouse profile.

What is the process for capturing Qt mouse button codes in Slicer?

Capturing Qt mouse button codes in Slicer involves running a Python event-filter script in the Slicer console. The script detects physical button presses and prints the corresponding Qt codes for you to record and map.

Can I map mouse buttons in Slicer if my mouse is not in the built-in profiles?

Yes, if your mouse is not in the built-in profiles, you can use the button-detection workflow to capture Qt codes via the Slicer Python console. You then translate these codes into a new mouse profile for use in Slicer modules.

Does the Slicer mouse button detection workflow work on macOS and Linux?

The Slicer mouse button detection workflow works across Windows, macOS, and Linux. It is suitable for users with non-standard mice or drivers that remap buttons, capturing Qt codes to create a new profile on any supported OS.

Do I need to use the Python console to detect mouse buttons in Slicer?

Yes, you need to use the Slicer Python console to detect mouse buttons. The workflow requires running a small Python event-filter script in the console to capture Qt button codes for mapping to a new profile.

Why are my non-standard mouse buttons not working in Slicer?

Non-standard mouse buttons may not work in Slicer because the mouse is not in built-in profiles. You need to detect the Qt button codes via the Slicer Python console and create a new mouse profile to map these codes to actions.