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.

Important

dwindle-autogroup follows hyprland-git and requires hyprland-git to work properly. If you want to use a versioned hyprland, you'll have to reset dwindle-autogroup to a commit from before that hyprland version's release date.

Before Hyprland v0.23.0beta, this groupping behavior was actually the default behavior, however as that release introduced group support for other layouts, including floating windows, this dwindle specific feature was removed (in PR #1580) 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.

Showcase

https://github.com/ItsDrike/hyprland-dwindle-autogroup/assets/20902250/31e60fcf-b741-4501-b20e-0e2bf0c65209

Installation

Hyprpm

The recommended way to install this plugin is via hyprpm:

• hyprpm add https://github.com/ItsDrike/hyprland-dwindle-autogroup
• hyprpm enable dwindle-autogroup

To automatically load the plugin when hyprland starts, add exec-once = hyprpm reload -n to your hyprland config.

Hyprload

Add the line "ItsDrike/hyprland-dwindle-autogroup" to your hyprload.toml config, like this:

plugins = [
    "ItsDrike/hyprland-dwindle-autogroup",
]

Then update via hyprload,update dispatcher.

Manual installation

1. Clone the Hyprland repository and build the plugin environment

   • git clone --recursive https://github.com/hyprwm/Hyprland
   • In the Hyprland directory: make pluginenv
   • Ideally, you should use this instance of Hyprland as your compositor, to do that, run make install. This is heavily recommended, as using a different Hyprland instance might cause incompatibilities.

2. Build the plugn

   • Run 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.