awesomewm-mirrors
/
awesomewm-machina
mirror of https://github.com/basaran/awesomewm-machina.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

readme

This commit is contained in:
anakha 2021-07-03 18:13:07 -04:00
parent b889665eb0
commit 63be63f5fd
1 changed files with 6 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
README.md
View File

@ -22,7 +22,7 @@ Relocate windows like Elv13's collision module.
Relocate windows clockwise or counter clockwise. This uses a different algorithm compared to directional shifting and should be more accurate in merging your floating clients to the tiling layout.
- Shuffling:
Go backward or forward in a region, and it will cycle the clients inside that area. Kind of like fake tabs.
Go backward or forward in a region, and it will cycle the clients inside that area.
- Auto-Hide Floating Windows:
Often times, the floating windows pollutes your background if you are using `useless-gaps`. Machina will hide those for you, but they can still be accessed through your window-switcher such as Rofi.
@ -30,11 +30,12 @@ Often times, the floating windows pollutes your background if you are using `use
- Floating and Tiled:
All keybindings, including swapping work seamlessy on both the tiled and the floating windows. So, if you need to push that terminal to a corner, you can easily do so without changing it to tiling mode.
- Experimental Tabs:
We now have tabs for tiled clients :)
### Next?
The region shuffling works like tabs, but it would be nice to have a visual queue like tabs. That will be in the next version. I'm also planning to add chained keybindings kind of like in emacs and vi that displays a modal help window.
New layout-machi has some logic to auto expand your windows onto multiple regions. For some work flows this might be desired, but I might look into a way to disable that as I find it to get in the way when changing windows from float to tile. This is especially annoying when you have a centered float.
New layout-machi has some logic to auto expand your windows onto multiple regions. I need to change region expansion to work nicely with it.
### Layout-Machi compatibility
@ -84,52 +85,9 @@ or, you can just copy / paste what you like from `init.lua` onto your rc.lua glo
Some of the default shortcuts are:
```lua
modkey + [ : shift to region (counter clock wise, infinite)
modkey + ] : shift to region (clock wise, infinite)
modkey + shift + [ : swap with client on left
modkey + shift + ] : swap with client on right
--|will keep the focus on the region you execute the
--|function, execute again to undo. if there is nothing on
--|the direction, it will look up or down.
-- Please see init.lua for keybindings and their descriptions.
modkey + ctrl + [ : swap with client below
modkey + ctrl + ] : swap with client above
--|useful for swapping with clients in corners
modkey + shift + ' : prev within region
modkey + shift + ; : next within region
modkey + insert : quick expand to left side (toggle)
modkey + pageup : quick expand to right side (toggle)
modkey + delete : expand client vertically
modkey + home : center (float or tiled)
--|you can use this one like zooming, when executed on tiled
--|clients, it will toggle back to original region.
modkey + end : toggle float status
modkey + j : focus left
modkey + k : focus down
modkey + l : focus right
modkey + i : focus up
modkey + shift + j : shift to left region
modkey + shift + k : shift to down region
modkey + shift + l : shift to right region
modkey + shift + i : shift to up region
modkey + shift + insert : move to top-left
modkey + shift + page_up : move to top-right
modkey + shift + home : move to center
modkey + shift + end : toggle always on
--|will keep the floating client always visible
modkey + shift + delete : move to bottom-left
modkey + shift + page_down : move to bottom-right
--|these will also work with tiled clients
```