e8f6064bd2
under the pointer. This is very useful for window management. When you have many windows open and you want to close some, you can just open revelation and close the windows with middle mouse. I have maintained your coding style, but I recommend not testing boolean variables against true/false. So instead of if mouse.buttons[1] == true then ... you would have if mouse.buttons[1] then and instead of if mouse.buttons[1] == false then -- doesn't actually appear in code you would have if not mouse.buttons[1] then ... That's just a minor niggle though. |
||
|---|---|---|
| README.md | ||
| init.lua | ||
README.md
revelation.lua
Provides Mac OSX like 'Expose' view of all clients.
Use
Installation
(From user's awesome configuration directory, usually ~/.config/awesome)
-
Clone repository:
git clone https://bioe007@github.com/bioe007/awesome-revelation.git -
put near the top of your rc.lua require("revelation")
-
Make a global keybinding for revelation in your rc.lua:
awful.key({modkey}, "e", revelation)NOTE: Always double check this key binding syntax against the version of Awesome that you are using.
-
Reload rc.lua and try the keybinding.
It should bring all clients to the current tag and set the layout to fair. You can focus clients with cursor or hjkl keys then press Enter or press the mouse right button to select or Escape to abort.
This is a modification of the original awesome library that implemented expose like behavior.
Configuration
Revelation's configuration is done through direct access to the module's
config table.
There are two basic settings, shown with default values:
-- The name of the tag created for the 'exposed' view
revelation.config.tag_name = 'Revelation'
-- A table of matcher functions (used in client filtering)
revelation.match.exact = awful.rules.match
revelation.match.any = awful.rules.match_any
The rule matching functions must conform to awful.rules.match prototypes.
For client matching rules, we follow the same syntax as awful.rules with one
perk; if rule.any == true, then we call the config.match.any function.
Examples
All clients:
awful.key({modkey}, "e", revelation)
To match all urxvt terminals:
awful.key({modkey}, "e", function()
revelation({class="URxvt"})
end)
To match clients with class 'foo' or 'bar':
awful.key({modkey}, "e", function()
revelation({
class={"foo", "bar"},
any=true
})
end)
Credits
Maintenance
* Perry Hargrave <resixian@gmail.com>
Contributions, many thanks!
* Nikola Petrov <nikolavp@gmail.com>
Original authors
* Espen Wiborg <espenhw@grumblesmurf.org>
* Julien Danjou <julien@danjou.info>
License
(c) 2008 Espen Wiborg, Julien Danjou