Provides Mac OSX like 'Expose' view of all clients.
This is a fork from revelation It is modified from the original revelation.lua for incorporating with awesome 3.5 or later. It also have some features.
Now master branch works for both master and stable awesome WM
When all clients are exposing, you can zoom (Modkey + Shift + hintbox charater or right button of the mouse) or kill a client (middle button of the mouse) and the position of hintboxes will be updated accordingly.
- Now the revlation is able to handle the special clients(float, fullscreen or maximized etc.)
- When you select an minimized client, the revelation will un-minimized it and then focuse on it.
- Added an option to change character ordering
-
Now it is possible, in revelation.init({...}), to change the default settings of revelation module.
-
Function
revelation(...)now accept the parameter as a table{rule={...}, is_excluded=..., curr_tag_only=...}.
- To add specify rules
revelation({rule={...},...}). - To exclude the clients matched by the rules instead of including
revelation({rule={...}, is_excluded=true}). {...,curr_tag_only=true}make the revelation only collect the client from current tags.
-
Support awesome 3.5 or later
-
Add the support of multiple screens. Now multiple 'Expose' views will be shown on the multiple screens at the same time.
-
The way of selecting and focusing the client was changed. The old way that is navigating clients by pressing the keys "j, h, k, l" and then selecting the client by pressing key "Enter" was deprecated. Now each client in the 'Expose' views come with a letter surrounding by a hint box, you can select the client by pressing the corresponding letter in the hint box. The idea and codes of this method was copied from the module hint.
-
Add zoom mode. Add the function of zooming the client by pressing the right button of the mouse.
-
The unwanted clients can be excluded by the parameter
{rule={...}....}.
(From user's awesome configuration directory, usually ~/.config/awesome)
-
Clone the repository:
git clone https://github.com/guotsuan/awesome-revelation revelation -
Include it at the top of your rc.lua file:
local revelation=require("revelation") -
Important: Add
revelation.init()afterbeautiful.init() -
Define a global keybinding (e. g.
ModKey + e) for revelation in your rc.lua:globalkeys = awful.util.table.join( awful.key({ modkey, }, "Left", awful.tag.viewprev ), awful.key({ modkey, }, "Right", awful.tag.viewnext ), awful.key({ modkey, }, "Escape", awful.tag.history.restore), awful.key({ modkey, }, "e", revelation), awful.key({ modkey, }, "j", function () awful.client.focus.byidx( 1) if client.focus then client.focus:raise() end end),NOTE: Always double check the key binding syntax against the version of Awesome which you are using.
-
Restart Awesome (usually Modkey + Control + r) and try the keybinding Modkey + e.
It should bring up all clients from the current tags on all screens and set the layout to fair. You can focus clients with the cursor keys, and then press the left button to select, or you can directly focus a client by pressing the corresponding key shown in the hint box. Press the right mouse button to zoom the client or Escape to abort.
Revelation's configuration is done through the init() function
There are three basic settings, shown with default values:
-- The name of the tag created for the 'exposed' view
revelation.tag_name = 'Revelation'
-- A table of matcher functions (used in client filtering)
revelation.exact = awful.rules.match
revelation.any = awful.rules.match_any
-- Character order for selecting clients
revelation.charorder = "jkluiopyhnmfdsatgvcewqzx1234567890",
The rule matching functions must conform to awful.rules.match prototypes.
For client matching rules, we follow the same syntax as awful.rules expects.
If rule.any == true, then we call the config.match.any function.
to change the settings, use:
revelation.init({tag_name = ..., match = {...}, charorder = ...})
All clients:
awful.key({modkey}, "e", revelation)
To match all urxvt terminals:
awful.key({modkey}, "e", function()
revelation({rule={class="URxvt"}})
end)
To match clients with class 'foo' or 'bar':
awful.key({modkey}, "e", function()
revelation({
rule{class={"foo", "bar"},
any=true}
})
end)
To exclude the clients, we set:
awful.key({modkey}, "e", function()
revelation({rule={class="conky"}, is_excluded=true})
end)
To set only collect clients from current tag
awful.key({modkey}, "e", function()
revelation({rule={class="conky"}, is_excluded=true,
curr_tag_only=true})
end)
* Quan Guo <[email protected]>
* Perry Hargrave <[email protected]>
* Daniel Hahler <[email protected]>
* Yauhen Kirylau
* Nikola Petrov <[email protected]>
* Espen Wiborg <[email protected]>
* Julien Danjou <[email protected]>
(c) 20013-2014 Quan Guo
(c) 2009-12 Perry Hargrave
(c) 2008 Espen Wiborg, Julien Danjou
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent