/dotfiles

awesomewm setup config files

Primary LanguageLua

img

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


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



img

Click here


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

img

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

Screenshots:

  • BlackLotus
  • OldBook


II

img

💻 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

img

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

img

(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

img

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

img

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!