https://github.com/zakk4223/hyprRiver

River layouts for Hyprland
https://github.com/zakk4223/hyprRiver

hyprland hyprland-plugin

Last synced: 6 days ago
JSON representation

River layouts for Hyprland

• Host: GitHub
• URL: https://github.com/zakk4223/hyprRiver
• Owner: zakk4223
• License: bsd-3-clause
• Created: 2023-03-13T12:38:11.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-10-21T02:48:21.000Z (19 days ago)
• Last Synced: 2024-10-21T05:59:55.646Z (18 days ago)
• Topics: hyprland, hyprland-plugin
• Language: C++
• Homepage:
• Size: 117 KB
• Stars: 42
• Watchers: 1
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-hyprland - hyprRiver

README

        
# hyprRiver

River layouts for Hyprland

This plugin implements the river-layout-v3 protocol for Hyprland. 

This was mostly a proof of concept/because I can thing. It _is_ usable, with the following limitations(?)

- You cannot have any workspace specific layout settings. Hyrpland and River do not use the same workspace model, so river layout providers have no idea how to track per-workspace settings.

- You cannot resize tiled windows. They will just get forced floating if you try (same as River)

River layouts provide a 'namespace' to the wayland server; this namespace is used to create a layout with the same name in Hyprland.

You can change to that layout by modifying the value of general:layout

All 'layoutmsg' dispatch commands are sent directly to the appropriate river layout provider. This may cause some unexpected lack of functionality in Hyprland.

### River layout providers

- [rivertile](https://github.com/riverwm/river)

- [kile](https://gitlab.com/snakedye/kile)

- [river-luatile](https://github.com/MaxVerevkin/river-luatile)

- [rivercarro](https://sr.ht/~novakane/rivercarro/)

### Installation

## Using hyprpm, Hyprland's official plugin manager (recommended)

1. Run `hyprpm add https://github.com/zakk4223/hyprRiver` and wait for hyprpm to build the plugin.

2. Run `hyprpm enable hyprRiver`