Almeida's .config backup & a noob's work in progress.

---

Original awesomewm desing by PapyElGringo, this version is based on ChrisTitusTech's fork.

---

---

Click here

• Galery

• Manual setup

• Program list

• Clone the files

• Auto setup

• Theme

• Keybind

• Documentation

---

---

A keyboard centered experience, with good mouse support.

This fork is a hybrid keyboard/mouse driven setup. The whole system can be controled by using the keyboard alone, but the keybinds focus on left hand usage by concentrating the controls in the W/A/S/D area and using the Super key as main modkey, freeing the user's right hand to use the mouse as needed.

These dotfiles are meant to be used with both OpenSuse Tumbleweed and Linux Mint using awesomewm as desktop environment, but they could work on any other distro with some tinkering.

Avaliable in both dark and light colorschemes:

🌸 BlackLotus:

📜 OldBook:

---

---

I

Click here

Top Panel:

• Left side (volume, time/calendar/date, wheather, spotify)

• Center (tag-list)

• Right side (cpu/ram usage, temperature, network, tile-layout)

---

Modules / Widgets:

• Exit-screen (P/R/S/O/L keys and mouse activation)

• Calendar (click time/date to show/hide and scroll to change month)

• Lock-screen (i3lock)

---

GTK / Icons:

• Nemo

---

Applications:

• Alacritty (Vim showing terminal colors)

• BpyTOP

• Ranger

• Rofi (based on Adamekka's config)

---

Screenshots:

• BlackLotus

• OldBook

---

---

II

💻 Program list:

(essential for out of the box usage)

⚙️ System

Name	Function	Description
awesomewm	Window manager	Main environment
JetBrainsMono Nerd Font	Font	Applied system-wide
alacritty	Terminal emulator	Fast and simple
rofi	App launcher	Functional and very customizable
nemo	File-manager	One of the best GUI file managers
picom	Compositor	Can be replaced with compton editing apps.lua
feh	Background setter	Simple but able to randomize
i3lock-color	Lockscreen application	Light and customizable
gnome-polkit	Policy handling	Integrates nicely for elevating programs that need root access
lxappearance	Icon/GTK/Cursor theme setter	Not necessary but helpful GUI option
xfce4-screenshooter	Screenshot app	Full-screen/Area/Delay support with GUI helper
network-manager-applet	NM systray display	Integrates nicely with any system
xfce4-power-manager	Power manager	Excellent for dealing with sleep, monitor timeout, and other power management features

🌸 BlackLotus theme-files

Name	Function	Description
Numix-BLACK-ice	GTK theme	Dark grey with light blue accents
BLACK-Pomegranate-Numix	Icon theme	Purple accent
Sunity-cursors	Cursor theme	Midway through classic and modern

📜 OldBook theme-files

Name	Function	Description
Breeze-Solarized-Light	GTK theme	Beautifully tanned
Adwaita	Icon theme	A classic
Sunity-cursors	Cursor theme	Midway through classic and modern

---

📥 Clone the files

git clone --depth=1 --recursive https://github.com/PoisonIsBestType/dotfiles.git

Then place the chosen files (BlackLotus or OldBook, Mint or Suse) into their respective folders:

• ~/.themes/, ~/.icons/ and ~/.fonts/ for theme-files
• ~/ for bash (optional)
• /lib/python3*/.../ranger/colorschemes/ for ranger/*.py
• ~/.config/ for the rest

---

---

III

---TODO---

Click here

For now, here are some dependencies install commands:

OpenSUSE Tumbleweed

sudo zypper install awesome awesome-extra picom polkit polkit-gnome arandr feh lxappearance opi timeshift alacritty rofi neovim ranger xclip nemo xfce4-power-manager file-roller firefox xfce4-screenshooter neofetch cava gimp udisks2 gparted vlc xed transmission evince git xbacklight flatpak

opi i3lock-color

flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install spotify vscodium citra

Linux Mint

sudo apt install awesome awesome-extra picom policykit-1-gnome arandr feh lxappearance timeshift alacritty rofi neovim ranger xclip nemo xfce4-power-manager file-roller firefox xfce4-screenshooter neofetch cava gimp udisks2 gparted vlc xed transmission evince git xbacklight spotify flatpak

sudo apt install autoconf gcc make pkg-config libpam0g-dev libcairo2-dev libfontconfig1-dev libxcb-composite0-dev libev-dev libx11-xcb-dev libxcb-xkb-dev libxcb-xinerama0-dev libxcb-randr0-dev libxcb-image0-dev libxcb-util-dev libxcb-xrm-dev libxkbcommon-dev libxkbcommon-x11-dev libjpeg-dev
git clone https://github.com/Raymo111/i3lock-color.git
cd i3lock-color
./install-i3lock-color.sh

flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install vscodium citra

Clone the files

git clone --depth=1 --recursive https://github.com/PoisonIsBestType/dotfiles.git
cd dotfiles
cp -r alacritty ~/.config/
cp -r awesome ~/.config/
cp -r bpytop ~/.config/
cp -r cava ~/.config/
cp -r gtk-3.0 ~/.config/
cp -r neofetch ~/.config/
cp -r ranger ~/.config/
cp -r rofi ~/.config/
cp -r theme-files/fonts/ ~/.fonts
cp -r theme-files/icons/ ~/.icons
cp -r theme-files/themes/ ~/.themes

Then:

• Move content outside from awesome-suse, awesome-mint, blacklotus, oldbook directorys as chosen.
• Delete the unneeded files.
• Move ranger/*.py to /lib/python3.11/site-packages/ranger/colorschemes or /lib/python3/dist-packages/ranger/colorschemes.

(Automated setup available soon, for both colorschemes in OpenSUSE and Mint)

---

---

IV

(by default the config files are set to BlackLotus)

• Set the chosen colorscheme by editing:

~/.config/awesome/theme/default-theme.lua

~/.config/awesome/configuration/apps.lua (set Lockscreen and Wallpaper)

~/.config/bpytop/bpytop.conf

~/.config/ranger/rc.conf

~/.config/rofi/menu.rasi

(For more wallpaper options you can access the BlackLotus and Oldbook repositories)

• Start lxappearance to activate the GTK, icons and cursor themes.

• Place (or edit) gtk-3.0/settings.ini in both ~/.config/gtk-3.0/ and /root/.config/gtk-3.0/ for the change to also show up in applications run as root. Also good idea to edit ~/.icons/default/index.theme and copy the theme-files to their respective /usr/share/ directories, to make sure the changes are applied system-wide.

---

---

V

MOD	KEY	Description
Super	F1	Show help
Super	F4	Exit screen
Super	F5	Reload awesome
Super	Pause	Lock screen
Super+Ctrl	Q	Quit awesome
Super	W/A/S/D/Z/X/C	View tag 1~7
Super+Ctrl	W/A/S/D/Z/X/C	Move focused client to tag 1~7
Super+Shift	W/A/S/D/Z/X/C	Toggle tag 1~7
Super	Q	Close focused client
Super	Enter	Open tag's default application
Super	R	Application launcher (Rofi)
Alt	Space	Rofi run
Super	T	Terminal
Super	G	File manager
Super	B	Browser
Super	H	Ranger
Super	M	BpyTOP
Super	Tab	Last viewed tag
Super	=	Next tag by index
Super	-	Previous tag by index
Super	Up	Focus client above
Super	Down	Focus client below
Super	Left	Focus client to the left
Super	Right	Focus client to the right
Super+Ctrl	Up	Move focused client up
Super+Ctrl	Down	Move focused client down
Super+Ctrl	Left	Move focused client left
Super+Ctrl	Right	Move focused client right
Super	Space	Toggle client floating
Super	F	Toggle client full-screen
Super+Shift	Space	Select next layout

---

---

VI

The documentation live within the source code.

The project is split in functional directories and in each of them there is a readme where you can get additional information about the them.

• Configuration is about all the settings available
• Keys is where all the keybinds are
• Layout hold the disposition of all the widgets
• Module contain all the features available
• Theme hold all the aesthetic aspects
• Widget contain all the widgets available

---

---

⬆️ Back to the top

---

This is a noob's repository, don't expect much!

Have a good one!

---