Hammerspoon/hammerspoon

Features

• Input Automation Tools - Intercepts and modifies system-wide mouse and keyboard input events for custom automation.
• Scripting Environments - Executes scripts that interact with native accessibility APIs, system notifications, and hardware interfaces.
• Window Managers - Provides grid-based window management and automated layout positioning for desktop applications.
• Desktop Automation - Provides a programmable automation engine for controlling system windows, hardware, and OS events.
• Window Management Utilities - Enables programmatic positioning, resizing, and organization of application windows using custom grid layouts and keyboard shortcuts.
• System Event Monitors - Provides a background service that triggers custom scripts in response to system-level events like network changes, battery status, and hardware connections.
• Keyboard Input Automation - Intercepts and modifies keyboard and mouse input to create custom shortcuts and macros.
• Modular Library Extensions - Supports loading self-contained modular extensions to tailor functionality to specific workflows.
• Application Scripting APIs - Automates interactions between applications by manipulating UI elements and accessibility objects.
• Grid Layout Managers - Positions and resizes windows to align with a virtual screen grid for precise layout management.
• Workflow Event Triggers - Triggers custom scripts and workflows in response to system-level events like battery or network changes.
• Input Event Interceptors - Intercepts keyboard and mouse events in real-time to allow for custom input remapping and automation.
• Language Bridges - Bridges Lua scripting with native Objective-C APIs to enable deep system-level automation.
• Runtime Lifecycle Controllers - Enables automated reloading of configurations and application restarts.
• Event-Driven Hook Systems - Registers asynchronous hooks for system-level notifications and hardware events to trigger scripts.
• System Automation Scripts - Executes AppleScript or JavaScript code to interact with system components via the Open Scripting Architecture.
• System Notifications - Creates and delivers custom alerts to the system notification center, supporting configurable text, images, sounds, and interactive buttons.
• Device-Specific Input Rules - Applies custom input remapping and transformation logic to specific hardware devices.
• Accessibility Inspection Tools - Retrieves accessibility objects to programmatically inspect and interact with system and application components.
• Accessibility-Based Window Manipulators - Interacts with the operating system accessibility tree to programmatically inspect and control application windows.
• Playback Controllers - Provides programmatic control over media playback states like play, pause, and seek.
• Window Lifecycle Controllers - Enables programmatic control over window visibility and lifecycle states.
• Notification Interaction Handlers - Registers callback functions that execute automatically when a user clicks or interacts with a specific notification.
• Automation And Scripting - Powerful automation tool using the Lua scripting engine.
• System Utilities - macOS automation tool for scripting system behavior.
• Productivity Tools - Listed in the “Productivity Tools” section of the Awesome Mac awesome list.
• Window Management - A powerful automation and window management scripting engine.
• Script-to-Native Type Mappings - Translates data types and function calls between high-level scripting and native system APIs.
• Media Controllers - Manages system audio, media playback, and external hardware devices through programmable interfaces.
• Mouse Control Automation - Provides programmatic control over mouse cursor movement and positioning.
• Plugin Lifecycle Management - Provides a framework for loading, configuring, and managing the lifecycle of modular automation extensions.
• Task Scheduling - Automates the execution of functions at fixed intervals or based on conditional predicates.
• Automated Action Execution - Triggers accessibility actions like button clicks or menu interactions to automate application workflows.
• Hardware Hub Callbacks - Registers callbacks to detect and respond to hardware button presses and state changes.
• Audio Volume APIs - Integrates system audio volume control into automation workflows.
• Window State Observers - Retrieves lists of open, visible, minimized, or focused windows to identify and interact with specific application interfaces.
• Modular Extension Systems - Loads self-contained units of functionality at runtime to extend core capabilities.
• User Interaction Simulation - Simulates user input by generating synthetic keyboard and mouse events to automate application interactions.
• Window Rules - Defines rule-based filters to include or exclude application windows from automation tasks.
• Window Lifecycle Monitors - Triggers callbacks when a webview window is moved, resized, closed, or changes focus state to enable responsive desktop automation.
• Input Event Dispatchers - Dispatches synthetic input events to the operating system to enable complex automation macros.
• Interactive UI Components - Accesses accessibility APIs to inspect and manipulate UI components of running applications.
• UI Element Selectors - Locates and queries UI elements based on structural relationships within the accessibility tree.
• Audio Hardware Interfaces - Queries and manages system audio hardware including volume, balance, and input sources.
• Configuration Persistence - Persists application settings and configuration states to local storage.
• Key Code Mappers - Facilitates event monitoring and hotkey assignment through key code mapping.
• Application Lifecycle Managers - Locates and manages running applications by process ID or bundle identifier to control their lifecycle.
• Window Visualizers - Displays a grid of active application windows to allow quick selection and navigation.
• Shell Command Utilities - Runs system shell commands and captures output for use within automation scripts.
• Interactive Resizers - Launches a modal interface for visually adjusting window dimensions and positions using keyboard shortcuts.
• Task Schedulers - Execute a function after a specified delay or at a specific time of day, with options for recurring intervals.
• Event Filter Lifecycle Managers - Allows for the temporary suspension and reactivation of event monitoring filters.
• Interactive Overlays - Displays interactive dialogs and alerts on the screen to provide visual feedback.
• Peripheral Device Managers - Supports the discovery and monitoring of specialized hardware peripherals.
• MIDI Message Transmitters - Transmits standard MIDI messages to control external hardware and virtual instruments.
• Spatial Window Managers - Provides spatial window management capabilities to organize and navigate application windows on the desktop.
• Process Lifecycle Managers - Runs automation logic within a persistent host process that manages lifecycle events.
• Power State Controllers - Provides programmatic control over system power states.
• Communication Bridges - Enables bidirectional data exchange and automation triggering between webview content and the host system.
• Application Lifecycle Monitors - Triggers custom logic in response to application launch, termination, or state changes via system-level notifications.
• Display Configuration Managers - Provides granular control over monitor hardware settings like resolution, scaling, and refresh rate.
• File System Monitors - Monitors file system paths for creation, modification, or deletion events to trigger automated scripts.
• Inter-Process Communication - Enables asynchronous data exchange and remote command execution between separate processes via local or remote ports.
• Window Query Filters - Retrieves lists of open windows based on active filter rules and focus history.
• Event Handling - Registers callbacks to respond to input events from external control hardware like encoders and touch screens.
• UI Event Watchers - Tracks UI interactions and state changes to trigger automated responses.
• Accessibility Attribute Modifiers - Allows for the programmatic modification of application UI element attributes.
• Script Injection Engines - Injects custom scripts into webviews to modify page environments and frame structures.
• Observable State Tables - Exposes shared data tables that trigger notifications upon modification for external observation.
• Application Identifiers - Identifies running applications by name or window title patterns.
• Automation Shortcuts - Triggers system shortcuts by name to perform automated tasks or workflows on the desktop.
• Clipboard Change Watchers - Triggers custom functions whenever the system clipboard contents are updated.
• Clipboard Writers - Updates the system clipboard with diverse data types for cross-application use.
• Input Source Switchers - Enables programmatic switching of system keyboard layouts and input methods.
• Modal Input Systems - Provides mechanisms to define temporary keyboard modes that intercept specific key combinations for custom automation workflows.
• Process Execution Utilities - Executes system binaries with custom arguments and captures output streams for integration into automation scripts.
• Remote Panel Controllers - Synchronizes software logic with the physical layout of professional control panels.
• URL Scheme Handlers - Registers callbacks to execute scripts when custom URL schemes or application events are triggered.
• URL Scheme Handlers - Allows for the programmatic management of default URL scheme handlers.
• Tabbed Window Groupers - Consolidates open windows of a specific application into a single tabbed interface.
• Volume Mount Watchers - Triggers callbacks whenever disk volumes are mounted, unmounted, or modified.
• Network Bridges - Manages smart lighting zones by sending network commands to hardware bridges.
• Custom Shape Rendering - Enables rendering of custom shapes, text, and images on a drawing surface for desktop overlays.
• Hardware Hub Connectors - Enables interaction with professional control panels via external hub software.
• Audio Device Watchers - Monitors audio hardware connections and triggers custom scripts upon configuration changes.
• Text Message Automation - Transmits text messages to specific recipients using the system messaging service via email address or phone number.
• HTTP Request Customization - Executes synchronous and asynchronous HTTP requests with support for custom headers and caching.
• Network Change Observers - Tracks the connectivity status of a specific network destination and triggers a callback function whenever the connection state changes.
• Socket Networking - Implements low-level TCP and Unix domain socket management for inter-process and network communication.
• Wireless Interface Controllers - Allows for the automated management of wireless network connections.
• Space Change Monitors - Provides event-driven hooks to trigger automation when the user switches between virtual desktop spaces.
• USB Device Connection Watchers - Triggers functions when USB devices are connected or disconnected, providing device identity details.
• Audio Input Selectors - Manages and selects system audio input and output sources for routing control.
• Space Change Monitors - Enables automation triggered by changes in the active desktop space.
• Hardware Connection Watchers - Detects and handles the connection or disconnection of external control devices.
• Scheduled Notification Triggers - Delivers alerts at a specific future time by defining a timestamp or date string for the notification trigger.
• Device Power Monitors - Triggers automated functions in response to changes in system battery status.
• Configuration Change Watchers - Triggers automated callbacks whenever specific system configuration keys are modified.
• Media Playback Observers - Tracks media application status and playback state for automated workflows.
• Location Tracking - Retrieves and monitors geographic location data to enable location-aware system automation.
• System Configuration Watchers - Watches system configuration keys and triggers callbacks upon modification.
• Application Window Managers - Provides programmatic control to list, filter, and retrieve application windows.
• Color Temperature Managers - Schedules and manages display color temperature shifts based on time of day.
• Menu Interaction Utilities - Discovers and programmatically selects application menu items to trigger actions.
• Element Property Inspection - Inspects accessibility objects to retrieve metadata and state information from application interface components.
• File Pickers - Invokes native system dialogs to select files or directories from local storage.
• Focus Management - Programmatically identifies the interface component currently holding system or application focus.
• Keyboard Navigation - Implements keyboard-driven window selection using visual overlays for efficient desktop navigation.
• Display Layout Managers - Positions screens within the global coordinate space to organize multi-monitor setups.
• Navigation Titles - Locates specific windows by searching for exact title matches or dynamic patterns.
• Screen Capture Tools - Generates image snapshots of displays or specific screen regions.
• Tabbed Window Navigation - Provides components for switching between grouped tabbed windows.
• Visual Overlays - Displays graphical objects and visual elements directly on the screen for custom desktop overlays.
• Hardware Control State Managers - Allows dynamic visual feedback and state management for connected professional hardware control panels.
• Accessibility Event Listeners - Provides hooks to track and respond to accessibility notifications from application interface elements.

Star history