Installation

Clone this repository into your awesome configuration directory:

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

Usage

Basic usage, in rc.lua:

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

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

Define keyboard shortcuts like so:

-- 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"}),
)

Options

Arguments that can be passed 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
icon_size	100	Size of icon in notification
position	"top_middle"	Notification position on the screen
visual	true	Whether to show workspace changes