awesome-workspace-grid/README.md

# awesome-workspace-grid

## Installation

Clone this repository into your `awesome` configuration directory:

```
cd ~/.config/awesome
git clone https://github.com/lmanul/awesome-workspace-grid.git
```

## Usage

Arguments to pass to the contructor (all of them are optional):

| Arg        | Default        | Description                         |
|------------|----------------|-------------------------------------|
| `rows`     | 2              | Number of rows (1 to 9)             |
| `columns`  | 3              | Number of columns (1 to 9)          |
| `cycle`    | `false`        | Whether to cycle at grid edges      |
| `position` | `"top_middle"` | Notification position on the screen |
| `visual`   | `true`         | Whether to show workspace changes   |

Please make sure that `rows` × `columns` is equal to your number of tags, as
defined by the call to `awful.tag()` in your configuration.

Sample usage in `rc.lua`:

```
local workspace_grid = require("awesome-workspace-grid")
grid = workspace_grid({
  rows = 3,
  columns = 3,
})

-- Insert after 'globalkeys' is defined but before it is passed to 'root':

tag_nav_mod_keys = { "Control" }
globalkeys = gears.table.join(globalkeys,
  awful.key(tag_nav_mod_keys, "Up",
            function () grid:navigate("up") end, {description = "Up", group="Tag"}),
  awful.key(tag_nav_mod_keys, "Down",
            function () grid:navigate("down") end, {description = "Down", group="Tag"}),
  awful.key(tag_nav_mod_keys, "Left",
            function () grid:navigate("left") end, {description = "Left", group="Tag"}),
  awful.key(tag_nav_mod_keys, "Right",
            function () grid:navigate("right") end, {description = "Right", group="Tag"}),
)
```