awesomewm-machina/README.md

2.8 KiB

Why?

Layout-machi is great, however it requires you to use its built-in switcher to manage your open windows. If you are shuffling, swapping, and moving things around often, this could become counter productive.

Machina is built on top of layout-machi, and allows you to bind frequently used actions to your keys and gives you additional user friendly features.

A combination of layout-machi and awesomewm-machina will give you a similar experience to fancy zones on windows.

What?

These are the features I added:

  • Quick Expand: Expand focused window to left, right, or vertically. This will make the window snap to the next available region.

  • Directional Swapping: Swap windows between regions.

  • Directional Shifting: Relocate windows like Elv13's collision module.

  • Rotational Shifting: 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.

  • 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.

  • 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?

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

Machina should work just fine with both versions of layout-machi.

Problems?

If you have any issues or recommendations, please feel free to open a request. PRs are most welcome.

Install

switch to your awesome config folder, typically at:

cd ~/.config/awesome

clone this repository:

git clone https://github.com/basaran/awesomewm-machina machina

and call it from your rc.lua

local machina = require('machina')()

Keybindings

This module directly injects into rc.lua and ideally, all keybindings should work unless you override them in your rc.lua.

If you have any issues, you can change in your rc.lua:

root.keys(globalkeys)

to:

root.keys(gears.table.join(root.keys(),globalkeys))

or, you can just copy / paste what you like from init.lua onto your rc.lua globalkeys table.

Some of the default shortcuts are:


-- Please see init.lua for keybindings and their descriptions.

Preview

https://user-images.githubusercontent.com/30809170/123538385-ab5f7b80-d702-11eb-9a14-e8b9045d9d27.mp4