Support

Mouseflare makes your pointer easy to see and follow, across one display or many.

Getting started

Mouseflare lives in your menu bar. Click its icon to turn effects on or off, switch profiles, and open Settings. Settings is where you choose ring styles, colors, sizes per display, and your own shortcuts.

Keyboard shortcuts

Every shortcut starts with Control + Option. You can change them in Settings.

`S`	Spotlight
`L`	Laser pointer
`I`	Draw on screen
`B`	Whiteboard or blackboard: turns the display under the pointer into a board you can draw on (Esc to leave)
`K`	Screenshot
`M`	Magnifier
`Z`	Live zoom
`T`	Countdown timer: each press steps through 1, 5, 10 and 25 minutes, then off
`G`	Guides
`W`	Window spotlight
`R`	Reading band
`F`	Find my cursor
`D`	Drop a pin

Permissions

Pointer effects, themes, the laser, drawing, focus tools and the timer need no special permission. A few optional features ask macOS for one the first time you use them:

Keystroke display needs Input Monitoring. Keys are shown on screen only, never stored or sent, and nothing is shown while a password field is focused.
Magnifier, Live zoom and Annotated screenshot need Screen Recording. Images stay on your Mac; screenshots go to Pictures/Mouseflare.

You can turn any permission off in System Settings > Privacy & Security. If a feature stops working after a macOS update, turn its permission off and on again there.

URL commands

Mouseflare responds to mouseflare:// links, so scripts, Shortcuts and tools like Stream Deck can control it. From Terminal: open -g "mouseflare://spotlight/toggle".

`overlay/on\|off\|toggle`	All effects on or off
`spotlight/...`	Spotlight (on, off or toggle)
`agent-mode/...`	Agent mode (on, off or toggle)
`laser`, `draw`, `board`, `loupe`, `zoom`, `guides`, `window-spotlight`, `reading-band`	Each takes `/on`, `/off` or `/toggle`; on its own it toggles. `magnifier` works as well as `loupe`.
`clear-ink`	Clear drawings
`screenshot`	Take an annotated screenshot
`find`	Find my cursor
`pin`	Drop a pin
`next-profile`, `profile/<name>`	Switch profiles
`teleport/<n>`	Move the pointer to display n (1 is the leftmost)
`timer`, `timer/<minutes>`, `timer/pause`, `timer/cancel`	Countdown timer
`theme/<name>`	Switch theme: classic, flame, neon, comet, atom, sun, planet, solar-system, basketball, baseball, soccer, football, tennis, eyeball, ufo, ufo-squadron, pixel-alien, arcade-crt, terminal, oscilloscope, cat, dog, dragon, d20, ghost, fireflies, custom-image
`settings`	Open Settings

Questions

Does Mouseflare work with AI computer-use agents?

Mouseflare is designed to stay out of an agent's way. Its overlay never accepts mouse input, and when software posts mouse events it switches to a plain ring.

Can I hide the effects from screen recordings?

Yes. In Settings, open Capture and Agent-safe and turn on "Hide from screenshots, recordings and screen sharing".

Does it work with several displays at different resolutions?

Yes. You can set the ring size and visibility for each display, and Mouseflare handles displays being plugged in and unplugged, and sleep and wake.

Which macOS do I need?

macOS 14 Sonoma or later.

Contact

Email support@peaksummitlabs.com. A real person reads it.