User Guide
==========

.. image:: ../../Screenshots/main-ui.png
   :alt: SlicerMouseMaster main interface
   :width: 100%

Welcome to the SlicerMouseMaster User Guide. This section covers everything you
need to know to configure and use MouseMaster for your workflow.

Getting Started
---------------

New to MouseMaster? Start here:

1. :doc:`installation` - Install the extension
2. :doc:`quick-start` - Get up and running in 5 minutes
3. :doc:`tutorial` - **Hands-on tutorial** with screenshots
4. :doc:`button-mapping` - Configure your mouse buttons

Advanced Topics
---------------

Once you're comfortable with the basics:

- :doc:`presets` - Save and share configurations
- :doc:`context-bindings` - Module-specific bindings
- :doc:`troubleshooting` - Common issues and solutions

Supported Mice
--------------

MouseMaster works with any mouse, but provides optimized profiles for:

- **Logitech MX Master 3S** - 6 buttons, fully supported
- **Logitech MX Master 4** - 6 buttons, fully supported
- **Generic 3-Button** - Basic support for standard mice
- **Generic 5-Button** - Support for mice with back/forward buttons

See :doc:`/reference/mouse-profiles` for detailed button mappings and features
for each supported mouse.

Don't see your mouse? Use the button detection wizard to create a custom profile.