Share Extension
Planned system Share menu handoff for images and videos.
The macOS Share Extension is planned after the v1.0.x direct-download launch. It is not part of the first public launch build.
Planned Flow
- In any macOS app (Preview, Safari, Finder, etc.), select an image or video
- Click the Share button (or right-click > Share)
- Select MouseViz from the share sheet
- The file opens automatically in the appropriate MouseViz editor
Images open in the Image Editor for annotation and heatmap overlay. Videos open in the Video Editor for trimming and compositing.
Supported File Types
| Type | Formats | Max per share |
|---|---|---|
| Images | PNG, JPEG, HEIC, WebP, GIF, TIFF, BMP | 10 |
| Videos | MP4, MOV | 5 |
Common Use Cases
From Preview
Open a screenshot in Preview, click Share > MouseViz to add heatmap overlays or annotate with click patterns.
From Finder
Select one or more image files in Finder, right-click > Share > MouseViz to batch-open them in the image editor.
From Safari
Right-click an image on a webpage, select Share > MouseViz to import it as a background for heatmap comparison.
From Screen Recording Apps
After recording with QuickTime or another tool, share the video directly to MouseViz for mouse overlay analysis.
Technical Details
The planned Share Extension will copy shared files to a temporary directory and hand them off to the main MouseViz app via the mouseviz://open-file URL scheme. No App Groups or shared containers should be required because both the extension and the main app can access the system temp directory.
Files are cleaned up automatically by macOS when no longer needed.
Planned after v1.0.x