Changelog

MouseViz now integrates with Apple Shortcuts, the macOS Share menu, and expands its URL Scheme API to 18 commands — making it fully automatable from Raycast, Alfred, Stream Deck, and custom scripts.

URL Scheme API

Expanded from 5 to 18 commands. New commands include pause/resume recording, add markers, overlay control, and query commands that copy JSON results to the clipboard for automation tools.

Apple Shortcuts

9 Siri-enabled actions available in the macOS Shortcuts app:

• Start, stop, pause, and resume recording
• Add named task markers during recording
• Get recording status with structured data
• List recent sessions from history
• Toggle the visualization overlay
• Export heatmaps to a directory

macOS Share Extension

Send images and videos from any macOS app to MouseViz via the system Share menu. Files open automatically in the image or video editor.

Bug Fixes

• Fixed App Intents (Start/Stop/Export) not triggering actions due to missing notification observers
• Extracted URL scheme routing into a dedicated router for maintainability

The first public release of MouseViz — a native macOS app that visualizes mouse movements, clicks, and scroll patterns in real time.

Recording

Record mouse activity across all apps with a configurable countdown timer, pause/resume support, and automatic event streaming to disk for bounded-memory recording.

Five Visualization Modes

• Heatmap — density map of mouse activity with configurable opacity and fade
• Trail — motion path following the cursor
• Click Pulses — visual ripple effects on clicks
• Spotlight — focus circle that highlights the active area
• Dead Zones — reveals areas of the screen with no mouse activity

Floating Control Bar

A CleanShot-style floating bar for quick access to recording controls, visualization toggles, and settings. Pin it to any screen edge, drag to reposition, or collapse to compact icon mode.

Export

Export your sessions as PNG screenshots, heatmap-only images, MP4 video with overlay, GIF for quick sharing, or raw JSON for external analysis.

UX Research Tools

Run structured study scripts with task markers, timestamped notes, and a floating conductor window. Compare sessions side by side and analyze recordings with AI-powered insights.

Menu Bar Integration

Full control from the menu bar — start/stop tracking, switch visualization modes, filter by app, and access all features without leaving your workflow.