50 lines
1.0 KiB
Markdown
50 lines
1.0 KiB
Markdown
# hyprland-columns-plugin
|
|
|
|
A custom Hyprland tiled layout plugin that arranges all tiled windows as equal-width vertical columns so every window remains visible on screen.
|
|
|
|
## Layout name
|
|
|
|
`columns`
|
|
|
|
## Build
|
|
|
|
```bash
|
|
cd ~/src/hyprland-columns-plugin
|
|
make
|
|
make install
|
|
```
|
|
|
|
This installs the plugin to:
|
|
|
|
```bash
|
|
~/.local/lib/hyprland/libhyprcolumns.so
|
|
```
|
|
|
|
## Load now
|
|
|
|
```bash
|
|
hyprctl plugin load ~/.local/lib/hyprland/libhyprcolumns.so
|
|
```
|
|
|
|
## Use it on the current workspace
|
|
|
|
```bash
|
|
hyprctl keyword workspace "$(hyprctl activeworkspace -j | jq -r '.id'), layout:columns"
|
|
```
|
|
|
|
## Persist across logins
|
|
|
|
Load it during Hyprland startup, e.g. from `~/.config/hypr/autostart.conf`:
|
|
|
|
```conf
|
|
exec-once = hyprctl plugin load /home/wayfinderak/.local/lib/hyprland/libhyprcolumns.so
|
|
```
|
|
|
|
## Behavior
|
|
|
|
- All tiled windows are shown at once.
|
|
- Each tiled window gets an equal-width column.
|
|
- Columns fill the workspace height.
|
|
- Left/right move and swap operations work naturally for the column order.
|
|
- Interactive resize is intentionally ignored to preserve equal columns.
|