https://github.com/2kabhishek/awesome2k
Awesome Window Management 🪟🚀
https://github.com/2kabhishek/awesome2k
List: awesome2k
awesome config desktop dotfiles linux widgets window-manager
Last synced: 6 months ago
JSON representation
Awesome Window Management 🪟🚀
- Host: GitHub
- URL: https://github.com/2kabhishek/awesome2k
- Owner: 2KAbhishek
- License: gpl-3.0
- Created: 2022-09-10T12:31:20.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-11-01T17:49:57.000Z (over 1 year ago)
- Last Synced: 2025-04-29T12:01:59.990Z (about 1 year ago)
- Topics: awesome, config, desktop, dotfiles, linux, widgets, window-manager
- Language: Lua
- Homepage:
- Size: 511 KB
- Stars: 6
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## What is this
My personalized configs for [awesome window manager](https://awesomewm.org/), optimized for an awesome experience.
## Prerequisites
Before you begin, ensure you have met the following requirements:
- `awesome` the window manager itself
- `rofi` with [rofi2k](https://github.com/2kabhishek/rofi2k) my preferred launcher
- `compton/picom` compositor, for transparency
- `lxappearance` for gtk styling
- `copyq` for clipboard management
- `nitrogen` for wallpapers
- `light` for display brightness
- `amixer` for volume management
- `autorandr` for multiple displays
- `i3lock/i3lock-fancy` for lockscreen in session widget
```bash
# Arch
sudo pacman -S awesome picom lxappearance copyq nitrogen light amixer autorandr rofi
# Debian
sudo apt install awesome picom lxappearance copyq nitrogen light amixer autorandr rofi
```
## Setting up awesome2k
To get awesome2k, follow these steps:
```bash
git clone https://github.com/2kabhishek/awesome2k
ln -sfnv "$PWD/awesome2k" ~/.config/awesome
```
### Widgets
Comes with a bunch of customized widgets:
- audio
- battery
- cpu
- disk
- network
- ram
- session
- text
- time
- todo
### Theming
Add the following bash function to your `~/.bashrc` or `~/.zshrc` file to customize awesome and rofi accent colors
```bash
accent() {
color="#1688f0"
if [[ $1 == '#'* ]]; then
color=$1
elif [ -z "$1" ]; then
color="#1688f0"
else
color="#$1"
fi
sed -i "s/local accent.*/local accent = '$color'/" ~/.config/awesome/awesome2k.lua
sed -i "s/selected.*/selected: $color;/" ~/.config/rofi/themes/shared/colors.rasi
echo 'awesome.restart()' | awesome-client
}
# Example usage: accent #454ec5
```
You can also install [pastel](https://github.com/sharkdp/pastel) and combine it with the accent function to pick and set any colour on your screen as accent
```bash
accent $(pastel pick | pastel format hex)
```
## Using awesome2k
Hit `Super + /` key to view keyboard shortcuts.
## Inspiration
After using KDE for a long time with tiling support and struggling with config management, finally decided to switch to awesome.
## How it was built
awesome2k was built using `nvim`
Hit the ⭐ button if you found this useful.
## More Info
- [sway2k](https://github.com/2kabhishek/sway2k) — Spiritual successor, Wayland based tiling wm configs
