awesomewm-mirrors
/
awesome-viewport
mirror of https://github.com/jcrd/awesome-viewport.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
awesome-viewport/README.md

1.1 KiB
Raw Blame History

awesome-viewport

awesome-viewport is a library for Awesome window manager that manages tags based on viewports.

Installation

$ git clone https://github.com/jcrd/awesome-viewport.git
$ cd awesome-viewport
$ luarocks make --local rockspec/awesome-viewport-devel-1.rockspec

Usage

Require the library:

local viewport = require("awesome-viewport")

Connect to a screen to begin managing its tags:

awful.screen.connect_for_each_screen(function (s)
      viewport.connect(s)
  end)

View a single tag:

tag1:view_only()

This tag will be the new viewport.

Get the viewport for the focused screen:

viewport()

Toggle another tag into view:

awful.tag.viewtoggle(tag2)

tag1 will remember that tag2 is toggled while its the viewport, so that if the viewport changes and tag1 is re-viewed, tag2 will also be toggled into view.

See the API documentation for descriptions of all functions.

License

awesome-viewport is licensed under the GNU General Public License v3.0 or later (see LICENSE).