# hy3 i3 / sway like layout for [hyprland](https://github.com/hyprwm/hyprland). ### Features - [x] i3 like tiling - [x] Window splits - [x] Window movement - [x] Window resizing - [ ] Selecting a group of windows at once (and related movement) - [ ] Tabbed groups - [ ] Some convenience dispatchers not found in i3 or sway ### Stability As of now hy3 is stable enough to use normally as long as you don't change layout after loading the plugin (currently unimplemented). If you encounter any crashes or bugs please report them in the issue tracker. When reporting bugs, please include: - Commit hash of the version you are running. - Steps to reproduce (if you can figure them out) - backtrace of the crash If you don't know how to reproduce it or can't, or you can't take a backtrace please still report the issue. ## Configuration Set your `general:layout` to `hy3` in hyprland.conf. hy3 requires using a few custom dispatchers for normal operation. In your hyprland config replace the following dispatchers: - `movefocus` -> `hy3:movefocus` - `movewindow` -> `hy3:movewindow` You can use `hy3:makegroup` to create a new split. ### Dispatcher list - `hy3:makegroup, ` - make a vertical or horizontal split - `hy3:movefocus, ` - move the focus left, up, down, or right - `hy3:movewindow, ` - move a window left, up, down, or right - `hy3:debugnodes` - print the node tree into the hyprland log ## Installing ### Nix Under nix, use the provided devShell, then go to [Manual Installation](#manual) ### [Hyprload](https://github.com/Duckonaut/hyprload) Add an entry to your hyprload.toml like so: ```toml plugins = [ # ... { git = "https://github.com/outfoxxed/hy3", branch = "master", name = "hy3" }, # ... ] ``` ### Manual First export `HYPRLAND_HEADERS`, then run the following commands: ```sh cmake -DCMAKE_BUILD_TYPE=Debug -B build cmake --build build ``` > **Note**: Please use a debug build as debugging a backtrace from a release build is much more difficult if you need to report an error. The plugin will be located at `build/libhy3.so`.