RamonUnch/AltSnap
AltSnap
AltSnap is a window manager utility and layout system that organizes application windows using custom snap grids and mouse-driven resizing and movement. It functions as a low-level input hook that intercepts keyboard and mouse events at the OS level to trigger custom window management actions.
The project includes a coordinate-based grid mapper for precise snapping to custom zones and an input remapper that assigns keyboard scan codes to virtual mouse buttons. It also features a window automation CLI used to trigger management tasks on foreground or targeted application windows.
The tool provides window layout management, dynamic window control to move and resize windows via modifier keys, and input filter middleware to restrict actions based on application blacklists, process names, or window titles. It further enables control over system volume and window transparency through mapped input triggers.
Features
- System Input Hooks - Intercepts raw keyboard and mouse hardware events at the OS level to trigger custom window management.
- Window Managers - Organizes application windows using a configurable grid and snapping zones to optimize screen real estate.
- Input Customization - Allows users to map keyboard scan codes to virtual mouse buttons for custom system actions.
- Interactive Window Manipulation - Moves and resizes windows using mouse clicks combined with modifier keys, bypassing title bars.
- Modifier-Key Window Manipulation - Enables moving and resizing application windows by holding modifier keys and clicking the window body.
- Grid Layout Managers - Implements a grid-based layout system for snapping windows into precise, organized zones.
- Input Remappers - Intercepts hardware input events to map keyboard scan codes to virtual mouse buttons.
- Input Remapping Utilities - Remaps physical hardware buttons and keyboard scan codes to system functions and window commands.
- OS-Level Input Hooks - Intercepts keyboard and mouse events at the OS level to trigger custom window management actions.
- Coordinate-Based Positioning - Calculates precise window positions and dimensions using a grid coordinate system for snapping.
- Window Snapping Coordinates - Calculates window positions and dimensions using a predefined coordinate system for precise snapping.
- Modifier-Conditional Mappings - Maps mouse movements and clicks to window resizing or movement based on active modifier keys.
- State Trackers - Monitors the real-time status of modifier keys to determine when mouse movements should resize windows.
- Native Window Layout Management - Aligns windows to predefined custom zones or a configurable grid for efficient screen organization.
- Command-Line Window Controllers - Provides a command-line interface to programmatically trigger window management tasks and layout changes.
- Window Action Filters - Restricts window actions based on application blacklists, process names, or window titles.
- Cross-Device Input Translation - Maps keyboard scan codes to virtual mouse buttons to increase available input triggers.
- Mouse Button Reconfigurations - Assigns keyboard scan codes to virtual mouse buttons to increase available input triggers.
- Virtual Input Triggers - Translates hardware mouse clicks into virtual input triggers to expand available command shortcuts.
- CLI System Management - Offers a CLI for triggering window management tasks and application controls via scripted setups.
- Process-Based Action Restrictions - Prevents interaction with specific programs or windows using process-based or title-based filtering lists.
- Input-Mapped Window Actions - Performs tasks like minimizing, maximizing, or closing windows by mapping mouse buttons to actions.
- Interaction Blacklists - Prevents specific applications from being affected by window movement and resizing overrides.
- Window Query Filters - Filters target windows using process names and titles to determine which windows should be managed.
- Input Filters - Filters keyboard and mouse events to prevent specific programs from being affected by window overrides.
- Window Management - Keyboard-driven window snapping and positioning tool.
