Initial commit

README.md

@@ -0,0 +1,49 @@
+# 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.