Skip to content

AndreaGriffiths11/annotation-overlay

Repository files navigation

Annotation Overlay

Draw over anything on your screen. Works during presentations, live demos, and screen sharing without switching windows or apps.

Demo Screenshot 2026-02-24 at 13 25 55

Install

No terminal needed.

Go to the Releases page and download the installer for your platform:

Platform File Size
macOS (Apple Silicon) Annotation.Overlay-1.2.1-arm64.dmg 133 MB
Windows Annotation.Overlay.Setup.1.2.1.exe 119 MB
Linux Annotation.Overlay-1.2.1.AppImage 122 MB

Open the installer and follow the prompts. Launch Annotation Overlay from Applications or your Start Menu.

macOS Installation

First Launch: macOS may show a security warning.

To open the app: 1. Right-click the app icon 2. Select “Open” 3. Click “Open” in the dialog

Alternative: System Settings → Privacy & Security → “Open Anyway”

Update

To update, download the latest installer from the Releases page and install it over the existing version.

For Developers

npm install
npm start

How It Works

The overlay sits on top of every window on your screen.

When you launch the app, a small Annotate capsule appears at the top-center of your screen. Click it or press Cmd+Shift+D to enter drawing mode.

When drawing mode is on, the toolbar appears and you can draw freely. When drawing mode is off, clicks pass through to whatever is underneath. Your annotations stay visible but stay out of the way.

You can also toggle drawing mode with Cmd+Shift+D on Mac or Ctrl+Shift+D on Windows and Linux.

Tools

Tool Shortcut What It Does
Pen P Freehand drawing
Rectangle R Drag to draw a rectangle
Arrow A Drag to draw an arrow
Highlighter G Semi-transparent wide stroke
Eraser E Click a stroke to delete it

Shortcuts

Action Mac Windows / Linux
Toggle drawing mode Cmd+Shift+D Ctrl+Shift+D
Exit drawing mode Escape Escape
Color picker C C
Stroke width W W
Undo Cmd+Z Ctrl+Z
Clear all X X
Screenshot Cmd+S Ctrl+S
Hide/show toolbar H H
Quit Cmd+Q Ctrl+Q

Permissions

On macOS, the app needs Screen Recording permission to capture screenshots. If you haven't granted it, the app will prompt you when you try to save a screenshot. You can manage this in System Settings > Privacy & Security > Screen Recording.

Tray Icon

Single-click the icon in the menu bar to toggle drawing mode on or off.

Right-click for quick access to toggle, clear, screenshot, and quit.

Screenshots

Cmd+S captures your full desktop with annotations on top and saves it as a PNG.

Browser Fallback

Open overlay.html directly in a browser for a basic annotation experience without the system-wide overlay.

Contributing

Contributions are welcome. See CONTRIBUTING.md to get started.

License

MIT

Sponsor this project

 

Packages

 
 
 

Contributors