dwt1--dotfiles/.config/awesome
Derek Taylor 3c981ddca1 Updating README. 2020-03-12 11:20:09 -05:00
..
freedesktop Fixing some mistakes. 2020-02-17 00:07:06 -06:00
lain Fixing some mistakes. 2020-02-17 00:07:06 -06:00
scripts Adding AwesomeWM to the dotfiles finally. 2019-05-27 21:09:53 -05:00
themes Fixing some mistakes. 2020-02-17 00:07:06 -06:00
README.md Updating README. 2020-03-12 11:20:09 -05:00
autostart.sh Adding AwesomeWM to the dotfiles finally. 2019-05-27 21:09:53 -05:00
rc.lua Updating README. 2020-03-12 11:12:09 -05:00

README.md

My Awesome Configuration

Screenshot of my desktop

Awesome is a highly configurable, tiling window manager for X. It is very fast, extensible and licensed under the GNU GPLv2 license. Awesome is a perfect "first" tiling window manager for those who want to try out tiling, but the extreme customization that you can achieve with awesome makes it a power user's dream. Awesome is configured with Lua.

Features

  • Simple enough for beginner's but flexible enough for the power user.
  • Extremely customizable, maybe more so than any other window manager.
  • Configured in Lua.
  • A documented API to configure and define the behavior of your window manager.

My Keybindings

The MODKEY is set to the Super key (aka the Windows key). I try to keep the keybindings consistent with all of my window managers.

Keybinding Action
MODKEY + RETURN opens terminal (alacritty is the terminal but can be easily changed)
MODKEY + SHIFT + RETURN opens run launcher (dmenu is the run launcher but can be easily changed)
MODKEY + SHIFT + c closes window with focus
MODKEY + SHIFT + r restarts awesome
MODKEY + SHIFT + q quits awesome
MODKEY + 1-9 switch focus to workspace (1-9)
MODKEY + SHIFT + 1-9 send focused window to workspace (1-9)
MODKEY + j switches focus between windows in the stack, going down
MODKEY + k switches focus between windows in the stack, going up
MODKEY + h switches focus between windows in the stack, going left
MODKEY + l switches focus between windows in the stack, going right
MODKEY + SHIFT + j rotates the windows in the stack, going down
MODKEY + SHIFT + k rotates the windows in the stack, going up
MODKEY + SHIFT + h rotates the windows in the stack, going left
MODKEY + SHIFT + l rotates the windows in the stack, going right
MODKEY + period switch focus to next monitor
MODKEY + comma switch focus to prev monitor

Getting Help With Awesome

IRC

You can join the #awesome channel on the OFTC IRC network.

IRC Webchat

Stack Overflow

You can ask questions on Stack Overflow.

Reddit

There is an awesome subreddit where you can share your work and ask questions.

Reporting issues

Please report any issues you have with AwesomeWM on our bugtracker.

Contributing code

You can submit pull requests on the github repository. Please read the contributing guide for any coding, documentation or patch guidelines.

Documentation

Online documentation is available here.

License

The project is licensed under GNU General Public License v2 or later. You can read it online at (v2 or v3).