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.