EventTapper

A suite of debugging tools for monitoring system events on macOS, built on top of EventTapCore.

Tools

EventTapper

A native macOS application built with SwiftUI and AppKit for monitoring and debugging system events in real-time. Features include:

EventTapCLI

A command-line interface for monitoring system events, perfect for scripts and terminal-based workflows.

# Monitor all events
event-tap

# Monitor keyboard events for 30 seconds
event-tap --duration 30 --types keyboard

# Monitor with timestamps in JSON format
event-tap -t --json

# Monitor specific event fields
event-tap --fields 39,40,45 --labeled-fields

# General usage
USAGE: event-tap [--duration <duration>] [--location <location>] [--placement <placement>] [--types <types>] [--fields <fields> ...] [--labeled-fields <labeled-fields>] [--json] [--timestamp]

CLI Usage

OVERVIEW: Monitor system events like keyboard and mouse input

OPTIONS:
  -d, --duration         Duration to monitor (in seconds)
  -l, --location        Location to monitor from (hid/session/annotated)
  -p, --placement       Tap placement (head/tail)
  --types              Filter by event type
  --fields             Display specific field values
  --labeled-fields     Show field labels
  --json              JSON output format
  -t, --timestamp     Include timestamps

Requirements

• macOS 15.0 or later
• Swift 5.9 or later for building from source

Acknowledgments

• EventTapCore
• PredicateView