Before we get started. Here is a quick list of everything you should know.
The window manager used is
AwesomeWM it has a scripting language called
For more information about lua visit here
|Name||Description||Why/Where is it needed?|
||Highly configurable framework window manager||isn't it obvious?|
||Window switcher, application launcher and dmenu replacement||Application launcher|
||A compositor for X11||a compositor with kawase-blur|
Dependencies needed to achieve the setup's full potential. These are optional.
|Name||Description||Will be used by|
||RandR-based backlight control application||Brightness widget and OSD|
||An alternative implementation of Linux sound support||Volume widget and OSD|
||Show battery status and other ACPI info||Power/Battery Widgets. No need for this if you're not using a laptop|
||Server-side application for playing music||Music widget|
||Minimalist command line interface to MPD||Music widget|
||Make image||Screenshot tool|
||Image viewer and wallpaper setter||Screenshot previews, wallpapers|
||Command line interface to the X11 clipboard||Will be used in saving the screenshots to clipboard|
||Property displayer for X||Custom titlebars for each client|
||An image viewing/manipulation program||Music widget/Extracts hardcoded album cover from songs|
||Manages bluetooth||default launch application for bluetooth widget|
||Sets color temperature of display according to time of day||Blue light widget|
||Manages power||default launch application for battery widget|
||upower - UPower command line tool||Battery widget|
||Generates a list of installed applications||Menu Module/Useful for generating app list|
||Google Noto emoji fonts||Emoji support for notification center|
||Command-line JSON processor||Read weather|
sublime textwith some plugins
Mod4 is the Windows key.
Mod4 + Return - Launch default terminal
Mod4 + ` Launch dropdown terminal
Mod4 + Shift + e - Launch default file manager
Mod4 + Shift + f - Launch default web browser
Mod4 + e - Launch application menu
Mod4 + Shift + r - Launch web search rofi
Mod4 + Shift + Escape Launch system monitor
Mod4 + F2 - Open today panel
Mod4 + F3 - Open notification panel
Mod4 + r - Open left dashboard
Mod4 + m - Toggle music widget
Control + Escape - Toggle system tray
Mod4 + l - Lock the screen
Mod4 + t - Toggle redshift filter
Mod4 + [ - Decrease the blur effect
Mod4 + ] - Increase the blur effect
Print - Take a screenshot
Mod4 + Shift + s - Take a selected screenshot
Mod4 + F1 - Show keybindings
Control + Mod4 + R - Reload awesome wm configuration
Control + Mod4 + q - Quit awesome wm
Configurationcontains the keybindings, client rules, tags, rofi and picom configuration, startup applications, credentials storage, and tag-list.
Layouthold the disposition of the widgets, panels and sidebars.
Modulecontains all the standalone extra modular features available. You can disable/enable them without causing errors.
Themeholds all the aesthetic aspects like colors, fonts, and beautiful configuration. It also contains the wallpapers and icons.
Widgetcontains all the widgets and its configurations.
Binariescontains all the binaries needed for a certain task.
Configure theme's colors/aesthetics?
Awesome WM uses the
beautiful library to beautify your setup.
Change the values here:
Configure Panels and bars?
The panels and sidebars are located in:
Top panel location:
Left panel location:
Right/Notificaton panel location:
The right/notification panel is optional, you can remove it from the top panel.
Configure Start-up and default applications
You can change the applications here:
You can check keybinds by pressing
Mod4 + F1.
Configure client rules?
The client rules manages the behaviour of the client. Is it floating? Is it above the other clients? Is it under the other clients, perhaps? What tag will the client spawn?
Configure client tags?
Tags are the "workspaces". Terminal, web browsers, text editors are few of the tags used here.
Configure the compositor?
The compositor we are using is tryone144's picom feature/dual_kawase branch that provides the
kawase blur shader. It gives the beautifulbeauty is subjective blur effect.
Compositor configuration file:
What is rofi? Rofi is a window switcher, application launcher, ssh dialog and dmenu replacement
We will use two rofi configuration. One is for application launcher and the second one is for web searching.
Rofi Application Launcher:
Rofi Web Search:
The calculator widget is the result of my boredom.
Enable keyboard support by hovering your mouse above the calculator.
Or toggle it on/off by pressing the keyboard button.
Only numbers, arithmetic operators, and decimal point is accepted.
BackSpaceto delete the last digit.
Escapeto clear the screen.
xstops the keygrabbing.
Stopping the keygrabbing mode:
The trash widget.. well errm.. is actually useful.
It monitors your trash directory using the AwesomeWM's
gio monitor trash:///, then updates the icon if there is changes.
It is better if you have a music file with metadata.
This is actually useful for basic screen recording.
This module is developed by PapyElGringo for his material-awesome. This module adds a backdrop blur to the dialogs and modals. You can disable it by setting the
false in the