Skip to content

Latest commit

 

History

13 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PinPoint

PinPoint is a native macOS crosshair overlay for Apple Silicon Macs. It provides a polished SwiftUI control panel, fullscreen-capable transparent overlay rendering, active-window following across Spaces, and editable/importable/exportable crosshair presets.

Preview

PinPoint macOS crosshair overlay interface

Quick Start

Install with Homebrew:

brew tap demureiskander/tap
brew install demureiskander/tap/pinpoint
open "$(brew --prefix pinpoint)/PinPoint.app"

Or run the installed launcher:

pinpoint

PinPoint may ask for Accessibility permission when Follow active window is enabled. Grant it in macOS System Settings so the overlay can follow the currently focused window across displays and Spaces.

Features

  • Transparent click-through crosshair overlay.
  • Fullscreen-capable overlay window using a non-activating panel.
  • Active-window following across macOS Spaces and displays.
  • 10 crosshair styles.
  • Named presets with create, rename, edit, delete, JSON import and JSON export controls.
  • Live SwiftUI settings UI.
  • Size, thickness, gap, dot, color, opacity, outline, pulse and position controls.
  • Single-display and all-displays overlay modes.
  • Menu bar controls.
  • Donate button linking to Tribute.
  • Reproducible .app and .dmg builds.

Build Locally

./scripts/build.sh

The app bundle is created at:

build/PinPoint.app

Package DMG

./scripts/package-dmg.sh

The DMG is created at:

dist/PinPoint.dmg

GitHub Releases

Every pushed tag matching v* triggers the release workflow. GitHub Actions builds PinPoint.app, packages dist/PinPoint.dmg, uploads it as a workflow artifact, and attaches the DMG to the GitHub Release assets.

Homebrew Tap

The tap formula lives in:

Formula/pinpoint.rb

The public tap command is:

brew tap demureiskander/tap
brew install demureiskander/tap/pinpoint

Notes

The local .app is ad-hoc signed. It is not Apple-notarized, so Gatekeeper can show a warning when launching a downloaded or copied build.

The fullscreen overlay works for normal macOS fullscreen and most borderless/windowed fullscreen apps. Some exclusive fullscreen Metal games can still draw above all third-party overlays.

License

Apache License 2.0. Copyright 2026 demureiskander. Redistributed copies and derivative works must retain the license and NOTICE attribution where required by Apache-2.0.

About

Native macOS crosshair overlay built with SwiftUI and AppKit

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages