Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bgutter/swm-grid

StumpWM Desktop Grid package.
https://github.com/bgutter/swm-grid

Last synced: about 2 months ago
JSON representation

StumpWM Desktop Grid package.

Awesome Lists containing this project

README

        

#+TITLE: swm-grid

[[./example.gif]]

Navigate groups (desktops) in StumpWM as a physical grid. Displays
desktop grid as a message, with the current group highlighted, while
navigating.

* Installation & Quickstart

In your config.lisp:

#+BEGIN_SRC common-lisp
(stumpwm:add-to-load-path "/path/to/cloned/swm-grid/")
(stumpwm:load-module "swm-grid")

(swm-grid:create-groups)

(stumpwm:define-key stumpwm:*top-map* (stumpwm:kbd "C-M-Right") "right-group")
(stumpwm:define-key stumpwm:*top-map* (stumpwm:kbd "C-M-Left") "left-group")
(stumpwm:define-key stumpwm:*top-map* (stumpwm:kbd "C-M-Down") "down-group")
(stumpwm:define-key stumpwm:*top-map* (stumpwm:kbd "C-M-Up") "up-group")
#+END_SRC

* Exported Symbols

| Name | Description |
|-------------------+-----------------------------------------------------------------------------------------------|
| =*width*= | Width of the grid, in groups (desktops) |
| =*height*= | Height of the grid, in groups (desktops) |
| =*default-group*= | Index of the default group. Will be selected after group creation. |
| =create-groups= | Call once at startup, after setting variables. Creates enough empty groups to fill the grid. |
| =DIRECTION-group= | ...where DIRECTION is left, right, up, or down. Navigate to the group in the given direction. |