kasper/phoenix

Features

• Workspace Automation Scripts - Provides comprehensive automation of screens, spaces, and application windows through custom JavaScript scripts.
• Workspace Automation Engines - Provides a JavaScript scripting engine to control system-level window and application behaviors.
• Dynamic Window Geometry Management - Provides a programmable 2D coordinate system to dynamically resize and reposition application windows.
• Programmable Window Managers - Provides a tool for controlling window geometry and application states on macOS using JavaScript scripts.
• macOS Workflow Automations - Creates custom system behaviors and automates repetitive tasks by scripting application states and shell commands on macOS.
• Workspace Layout Automations - Automates the arrangement and sizing of application windows and screens through programmable shortcuts.
• Global Hotkey Triggers - Maps physical keyboard input combinations to JavaScript callbacks for executing automated tasks.
• Custom Action Bindings - Binds keyboard combinations and system events to execute specific callback functions.
• Window Reference Resolution - Retrieves window references based on focus, screen position, or usage order to target specific applications.
• Scriptable Screen Layouts - Manipulates window positions and screen spaces based on custom scripts to organize complex workspace layouts.
• Event-Based Triggers - Binds keyboard shortcuts and system events to JavaScript functions to trigger automated workspace tasks.
• Window State Toggles - Toggles window states including fullscreen mode, minimization, and visibility.
• Window Geometry Managers - Modifies the position, size, and frame of application windows using a 2D coordinate system.
• Screen Dimension Queries - Retrieves full and visible screen coordinates to determine optimal window positioning.
• AppleScript Integrations - Uses AppleScript to communicate with macOS internals for manipulating window geometry and application states.
• Virtual Space Management - Retrieves the current active space or a list of all available spaces associated with a specific display.
• OS-Level System Scripting - Uses a JavaScript runtime to control macOS internals and execute asynchronous system processes via AppleScript.
• Keyboard Shortcut Mappings - Binds keyboard shortcuts to JavaScript functions to trigger system-level window and application actions.
• Application Window Managers - Identifies and retrieves references to main or collected application windows to enable programmatic control.
• Window Query Filters - Retrieves window metadata including titles, associated applications, and assigned spaces for automation targeting.
• Keyboard Shortcuts - Maps specific keys and modifier combinations to trigger automated actions.
• Window Snapping Coordinates - Implements a coordinate system for precise window placement and alignment on the screen.
• Window Organizers - Organizes application window positions and sizes across multiple screens using a programmable coordinate system.
• Window Focus Control - Provides programmatic control over window z-index, focus, and bringing windows to the foreground.
• macOS Workspace Managers - Manages virtual spaces and application visibility to maintain a structured and productive desktop layout.
• Application Lifecycle Managers - Launches, terminates, or retrieves running applications by name or state to control which programs are active.
• External Command Execution - Runs system programs and captures their output for further programmatic use asynchronously.
• macOS Cursor Controllers - Provides the ability to track the cursor position and programmatically move it to specific screen coordinates.
• Modular Configuration Loading - Supports loading external JavaScript configuration files from dedicated directories to separate core and personal settings.
• Shell Command Execution - Runs external command line instructions from within scripts to integrate with system utilities.
• Display Enumeration - Identifies the primary screen or enumerates all connected displays to support multi-monitor window layouts.
• JavaScript Engines - Implements a JavaScript runtime to execute custom user logic for macOS desktop interactions.
• Asynchronous Command Execution - Runs shell commands and external scripts in background threads to prevent the main execution loop from freezing.
• Configuration Hot Reloading - Allows applying configuration changes in real-time without requiring an application restart.
• Application State Querying - Retrieves metadata such as process identifiers, bundle IDs, and visibility status for running applications.
• Window Visibility Controllers - Shows, hides, or activates applications to bring them to the foreground or remove them from view.
• Window Coordinate Mappings - Calculates window positions and sizes using a 2D coordinate system relative to screen origin points.
• Web Browsers - Lightweight window and app manager scriptable with JavaScript.
• Window Management - Lightweight JavaScript-scriptable window and app manager.

Star history