Skip to main content

​
Overview

Mouse Highlighter displays colorful visual effects around your cursor whenever you click the left or right mouse button. This makes mouse clicks more visible during presentations, screen recordings, or tutorials.
Mouse Highlighter is ideal for creating instructional videos or demonstrating software workflows where click visibility is important.

​
How to Activate

​
Toggle Highlighter

Press the activation shortcut to enable or disable Mouse Highlighter:
  • Default shortcut: Win + Shift + H

​
Auto-Activate Mode

Enable “Auto-activate” in settings to have Mouse Highlighter start automatically when PowerToys launches.

​
Configuration Options

​
Activation Settings

​
activation_shortcut
hotkey
default:"Win + Shift + H"
Keyboard shortcut to toggle Mouse Highlighter on and off
​
auto_activate
boolean
default:"false"
Automatically enable Mouse Highlighter when PowerToys starts

​
Appearance Settings

​
left_button_click_color
color
default:"#FFFF00A6"
Color of the highlight effect for left mouse button clicks (ARGB format with transparency)
​
right_button_click_color
color
default:"#FF0099FF"
Color of the highlight effect for right mouse button clicks (ARGB format with transparency)
​
always_color
color
default:"#00FFFFFF"
Color for continuous highlight mode (when spotlight mode is disabled). Default is fully transparent.
​
highlight_radius
number
default:"20"
Radius of the highlight circle in pixels
​
highlight_fade_delay_ms
number
default:"500"
Time in milliseconds before the highlight starts to fade after appearing
​
highlight_fade_duration_ms
number
default:"250"
Duration in milliseconds for the fade-out animation

​
Display Mode

​
spotlight_mode
boolean
default:"false"
Enable spotlight mode: shows highlight only during clicks. When disabled, shows a continuous highlight around the cursor using the “always_color” setting.

​
Use Cases

​
Tutorial Videos

Make mouse clicks visible in screen recordings so viewers can follow along with your actions. 
Scenario: Recording a software tutorial
Setup: Enable auto-activate, set fade delay to 400ms
Result: Each click shows a colored ring that helps viewers track actions

​
Presentations

Highlight where you’re clicking during live demonstrations to help audience members follow along on large screens.
Use contrasting colors for left and right clicks (yellow for left, blue for right) to make different interactions clear.

​
Accessibility

Help users with visual processing difficulties track mouse interactions by making clicks more prominent.

​
Software Testing

Document bug reports or test cases with visible click indicators in screen captures.

​
Visual Customization Tips

​
High Contrast Environments

For dark backgrounds:
  • Use bright colors: #FFFFFF00 (yellow), #FF00FFFF (cyan)
For light backgrounds:
  • Use darker, saturated colors: #FFFF0000 (red), #FF0000FF (blue)

​
Transparency Settings

The first two digits in the ARGB color format control transparency:
  • FF = fully opaque (255)
  • CC = 80% opaque (204)
  • 99 = 60% opaque (153)
  • 66 = 40% opaque (102)
Example: #99FF0000 = semi-transparent red

​
Performance Optimization

For better performance on older systems:
  • Reduce fade duration to 100-150ms
  • Reduce highlight radius to 15-18 pixels
  • Use spotlight mode (shows highlights only on click)

​
Source Code Reference

The Mouse Highlighter implementation can be found at:
  • Module interface: src/modules/MouseUtils/MouseHighlighter/dllmain.cpp
  • Settings parsing: Lines 191-407 in dllmain.cpp
  • Default hotkey: Line 404 (Win + Shift + H)

Build docs developers (and LLMs) love

Get started for freeTalk to us