A modern window grid manager for Hyprland that allows for precise window positioning using a configurable grid system.
- Configurable grid system (rows, columns, gaps)
- Save and load window positions
- Keyboard shortcuts for quick window positioning
- Visual grid editor for creating custom layouts
- Rule-based window positioning
- Multiple monitor support
- Qt6 (Core, GUI, Widgets, Network)
- CMake (3.16+)
- GCC with C++17 support
- Clone the repository:
git clone https://github.com/username/hyprgrid.git
cd hyprgrid- Build the application:
./build.sh- Install the application:
./build.sh --installhypr-grid-manager [options]
Options:
-a, --apply <preset:position>: Apply a window position from a preset-r, --reset: Reset window state and clear rules-c, --config: Print current configuration-u, --ui: Show the configuration UI
Apply a position:
hypr-grid-manager -a default:top-leftReset window state:
hypr-grid-manager -rOpen the UI:
hypr-grid-manager -uAdd these bindings to your Hyprland configuration:
# Grid manager UI
bind = Super+Control, Return, exec, hypr-grid-manager -u
# Apply grid positions
bind = Super, KP_7, exec, hypr-grid-manager -a default:top-left
bind = Super, KP_8, exec, hypr-grid-manager -a default:top
bind = Super, KP_9, exec, hypr-grid-manager -a default:top-right
# ...more bindings...
The configuration file is stored at ~/.config/hypr/qt-grid-manager/config.json. You can edit this file directly or use the UI to manage your grid layouts.
MIT