Hyprland plugin that overrides groupping behavior on dwindle layout to automatically group child nodes on creation
Go to file
ItsDrike 6218a99a3a
Move to pkg-config
Hyprland has recently changed the way plugins recognize the hyprland
headers, moving from directly including the paths with -I option to
automatically generating the cflags with `pkg-config --cflags hyprland`.

This change means that compilation attempts using the direct include
option will start to fail with newer versions of hyprland, which now
uses /usr/local/include for it's headers after `make pluginenv`.

This commit migrates the original system to respect this change,
modifying Makefile, and with it, the include paths for hyprland headers,
which are now prefixed with hyprland/.
2023-06-06 23:48:28 +02:00
include Move to pkg-config 2023-06-06 23:48:28 +02:00
src Move to pkg-config 2023-06-06 23:48:28 +02:00
.clang-format Update clang-format 2023-03-31 15:48:55 +02:00
.gitignore Initial commit 2023-03-31 14:56:32 +02:00
hyprload.toml Initial commit 2023-03-31 14:56:32 +02:00
LICENSE Add license 2023-03-31 22:56:49 +02:00
Makefile Move to pkg-config 2023-06-06 23:48:28 +02:00
README.md Mention minimum hyprland version requirement 2023-03-31 23:10:58 +02:00

Dwindle-Autogroup

This plugin changes the behavior of the togglegroup dispatcher for dwindle layout, to automatically group all of the child windows when a new group is created.

Before Hyprland v0.23.0beta, this was actually the default behavior (PR #1580), however as that release introduced group support for other layouts, including floating windows, this dwindle specific feature was removed and togglegroup now only creates a group window, and requires you to move in all of the windows that should be a part of that group into it manually.

Installation

Since Hyprland plugins don't have ABI guarantees, you should download the Hyprland source and compile it if you plan to use plugins. This ensures the compiler version is the same between the Hyprland build you're running, and the plugins you are using.

The guide on compiling and installing Hyprland manually is on the wiki

Note, this plugin currently requires hyprland compiled from commit: 16bc5 or later.

Using hyprload

  1. Export the HYPRLAND_HEADERS variable to point to the root directory of the Hyprland repo
    • export HYPRLAND_HEADERS="$HOME/repos/Hyprland"
  2. Install
    • make install

Manual installation

  1. Export the HYPRLAND_HEADERS variable to point to the root directory of the Hyprland repo
    • export HYPRLAND_HEADERS="$HOME/repos/Hyprland"
  2. Compile
    • make all
  3. Add this line to the bottom of your hyprland config
    • exec-once=hyprctl plugin load <ABSOLUTE PATH TO split-monitor-workspaces.so>

Development

When developing, it is useful to run make clangd, to generate compile_flags.txt file, allowing Clang language server to properly recognize the imports, and give you autocompletion.

Disclaimer

I'm very new to C++ development, and I'm also not very familiar with Hyprland's codebase. So while I will do my best to follow best practices, with so little experience, you can be pretty much certain that there will be bugs, and that the code will not be pretty. But hey, if you know about something that I did wrong, feel free to PR/make an issue about it.