Awespuccin

Welcome to my .files! 🔥

Awespuccin - a AwesomeWM Catppuccin config

Welcome to my AwesomeWM configuration files!

This is my personal repository, everything is themed with the Catppuccin Mocha Colorscheme.

These dotfiles are optimized for a 1920x1080 screen, if you have any issues/suggestions please let me know!

This is a Desktop configuration (no Brightness/Battery Support)!

Feel free to steal anything from here but don't forget to give me credits :)

AwesomeWM is the most powerful and highly configurable next-generation framework window manager for X. Although it takes time and effort to configure it, I am satisfied with the result.

❄️ Information

Here are some details about my setup:

• OS: Arch Linux
• WM: awesome
• Terminal: alacritty
• Shell: zsh
• Editor: vscodium
• Compositor: picom
• Application Launcher: rofi
• Music Player ncmpcpp

AwesomeWM Modules:

• bling
  • Adds new layouts, modules, and widgets that try to focus on window management primarily
• layout-machi
  • Manual layout for Awesome with an interactive editor
• rubato
  • Animation library for AwesomeWM

Main Features:

• Catppuccin Mocha Colorscheme
• Cool Window decorations
• Info Panel
• Notification Panel
• Top Panel
• Minimalist Exit Screen
• App Launcher
• Volume OSD with Mute Indication
• LayoutList PopUP
• Many cool Widgets
• Animated Systray
• Beautiful Naughty Notifications
• Right-Click Main Menu
• Playerctl Support
• Scratchpad
• Screenshot Tool

🔧 Setup

1. Install the Dependencies

⚠️ **This setup instructions only provided for Arch Linux (and other Arch-based distributions)**

Assuming your AUR Helper is yay.

First of all you should install the git version of AwesomeWM.

yay -S awesome-git

Install necessary dependencies

yay -S picom-git alacritty mpc playerctl ncmpcpp mpd xdg-utils \
pipewire pipewire-pulse pipewire-alsa alsa-utils feh rofi maim \
xclip jq pamixer colord mpdris2 imagemagick inotify-tools --needed

Enable Services

systemctl --user enable mpd.service
systemctl --user start mpd.service
systemctl --user enable mpDris2.service
systemctl --user start mpDris2.service

Optional Programms

yay -S thunar ranger vim zsh firefox pavucontrol gotop vscodium

Font/Theming

yay -S nerd-fonts-fira-code catppuccin-gtk-theme-mocha tela-circle-icon-theme-git

2. Install Dotfiles

Clone this repository

git clone --depth 1 --recurse-submodules https://github.com/V2BlockBuster2K/Awespuccin.git
cd Awespuccin && git submodule update --remote --merge

Copy config/desktop files

cp -r conf/* ~/.config/
cp -r desktop/ ~/

Install FiraCode Nerd Font if you haven't already done so

cp -r misc/FiraCode ~/.fonts/
# or to ~/.local/share/fonts
cp -r misc/FiraCode ~/.local/share/fonts/

And run this command for your system to detect the newly installed font

fc-cache -fv

3. Edit Configs

Edit ~/.config/awesome/user_variables.lua enter your Weater API Key from Openweathermap here

key = " ",

Add coordinates which you can find if you search your city name on Openweathermap here

coordinates = {
" ", --- lat
" ", --- lon

Add your microphone name which you can get throuh pamixer --list-sources | grep input here

mic = {
   -- For example "alsa_input.pci-0000_00_1b.0.analog-stereo"
   name = " ",

Add disk name which you can find throuh lsblk here

disk = {
   -- For example "/dev/sda2"
   name = " ",

Last but not least, you can change your profile picture in ~/.config/awesome/themes/catppuccin/theme.lua line 73 "theme.pfp" to your image name (you can also change wallpaper, font... in theme.lua )

theme.pfp = themes_path.."catppuccin/assets/yournamehere.png"
-- default path is "catppuccin/assets/pfp.jpg"

You maybe have to edit ~/.xinitrc to change Keyboard Layout and Display Resolution

After that's all setup, you are done, you can now try out your new Desktop! 🎉

Log out from your current desktop session and just startx!

🎨 Colorscheme

The colorscheme is Catppuccin Mocha which is a colorful good looking pastel colorscheme, there are way more configs available for many different programms on there repo (cava, vim, discord...), so go check them out!

🌊 Gallery

Useful Top Panel

Informative Info Center

Beautiful Notification Center

Naughty Notifications

Layout Popup

Simplistic Main-Menu

Volume Popup

Minimalist Exitscreen

⌨️ Keybinds

Just press ctrl+super+s and you will get a full list of keybinds!

Basic Keybinds

Keybinds	Uses
Mod + Enter	Terminal
Mod + Space	Layout
Mod + r	Rofi
Mod + Ctrl + n	Un-minimize
Mod + q	Lockscreen

📜 License

Awespuccin is under GNU GPL-3.0 License.

👤 Author

Awespuccin is created by V2BlockBuster2K.

✅ Todo

• Rework buttons (animations) (Playerctl) -> Hover effects on panels
• Add decoration for ncmpcpp
• Github widget (notfication-panel)
• Clickable calendar (info-panel)
• Rework main-menu

❤️ Credits

• Rxyhn
• Kasper24
• rklyz
• unixsea

And everyone on the r/awesomewm subreddit and AwesomeWM Discord who helped me with this Rice! 🔥