https://github.com/tomcur/tarn

[mirror] River layout generators
https://github.com/tomcur/tarn

riverwm wayland wayland-compositor zig

Last synced: about 14 hours ago
JSON representation

[mirror] River layout generators

• Host: GitHub
• URL: https://github.com/tomcur/tarn
• Owner: tomcur
• License: gpl-3.0
• Created: 2024-05-01T10:23:14.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-12-29T10:52:51.000Z (5 days ago)
• Last Synced: 2024-12-29T11:28:17.491Z (5 days ago)
• Topics: riverwm, wayland, wayland-compositor, zig
• Language: Zig
• Homepage: https://codeberg.org/tomcur/tarn
• Size: 82 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Tarn

Tarn is a collection of [River](https://codeberg.org/river/river) layout

generators (currently N=1).

## Included layouts

- tarn-dwindle: a dwindling layout with horizontal and vertical dwindle ratios

  specifiably separately

## Usage

Tarn provides separate binaries for each layout.

```bash

$ tarn-dwindle -h

```

### tarn-dwindle

You can send layout commands to update the Dwindle layout ratios, for example:

```bash

riverctl map normal Super+Control H send-layout-cmd tarn-dwindle "horizontal-ratio -0.05"

riverctl map normal Super+Control J send-layout-cmd tarn-dwindle "vertical-ratio +0.05"

riverctl map normal Super+Control K send-layout-cmd tarn-dwindle "vertical-ratio -0.05"

riverctl map normal Super+Control L send-layout-cmd tarn-dwindle "horizontal-ratio +0.05"

```

## Installing

Using Nix

```bash

$ nix build git+https://codeberg.org/tomcur/tarn.git

```

You can use the provided flake to install Tarn in a flake-based NixOS configuration. For example:

```nix

{

  description = "Your system config";

  inputs = {

    # ..

    tarn = {

      url = "git+https://codeberg.org/tomcur/tarn.git";

      inputs.nixpkgs.follows = "nixpkgs";

    };

  };

  outputs = { nixpkgs, tarn, ... }: {

    nixosConfigurations = {

      yourSystem =

        let

          system = "x86_64-linux";

          modules = [

            {

              nixpkgs.overlays = [

                (self: super: {

                  tarn = tarn.packages.${system}.default;

                })

              ]

            }

          ];

        in

        nixpkgs.lib.nixosSystem {

          inherit system modules;

        };

    };

  };

}

```