Skip to main content
Recording

Recording Settings

Configure recording behavior, countdown, keystroke overlay, and storage.

Accessing Settings

Open settings from the menu bar icon or via mouseviz://settings.

Countdown Timer

Configure the delay before recording starts:

  • 3 seconds — Quick start (default)
  • 5 seconds — Time to switch windows
  • 10 seconds — Longer preparation time

Keystroke Overlay

Choose how keyboard activity is displayed:

  • Modifier-only — Shows only modifier keys (⌘, ⇧, ⌃, ⌥). Best for privacy.
  • All keystrokes — Shows all key presses. Useful for tutorials and demos.

Frame Rate and Resolution

Adjust the recording frame rate and resolution for your needs. Higher settings produce smoother playback and more detailed heatmaps but create larger session files.

Clean Desktop Mode

When enabled, MouseViz automatically hides desktop icons during recording. Useful for screen demos and presentations.

Default Save Location

Sessions are saved to ~/Library/Application Support/MouseViz/Sessions/ by default. You can change the save location in settings.

Default Visualization Settings

Configure default visibility for each visualization layer (heatmap, trail, clicks, spotlight) so they're ready when you start recording.

Searchable Settings

All settings are searchable — use the search field at the top of the Settings window to quickly find any option.