My AwesomeWM Configuration Files
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
gallant 2516b682d3 god bless rxyhn 5 months ago
.github god bless rxyhn 5 months ago
bin this one for u acid 5 months ago
config this one for u acid 5 months ago
misc this one for u acid 5 months ago
LICENSE feat: GNU GPLv3 License 8 months ago


let it be known that I do not own the code to this rice, this is only a modified fork. Go support them at [here] (

Hi there! Thanks for dropping by! :heart_on_fire:

AwesomeWM Logo

Rxyhn's Aesthetic AwesomeWM Configuration Files!

Welcome to my AwesomeWM configuration files!

This is my personal collection of configuration files.

You might be here for looking my AwesomeWM configuration files? or looking for Linux Rice reference?

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, but I'm very satisfied with this aesthetic result.


Here are some details about my setup:

AwesomeWM Modules:

  • bling
    • Adds new layouts, modules, and widgets that try to primarily focus on window management
  • color
    • Clean and efficient api for color conversion in lua
  • layout-machi
    • Manual layout for Awesome with an interactive editor
  • UPower Battery Widget
    • A UPowerGlib based battery widget for the Awesome WM

Main Features:

  • Eye-catching Colorscheme
  • MacOS like window decorations
  • Dashboard
  • Info Center
  • Notification Center
  • Bottom Panel
  • Word Clock Lockscreen
  • Minimalist Exit Screen
  • Music Player
  • App Launcher
  • Github Activity Previews
  • Brightness / Volume OSD
  • LayoutList PopUP
  • Battery Indicator
  • Wifi Indicator
  • Calendar
  • Weather
  • Animated Workspace Indicator
  • Beautiful Naughty Notification
  • Main Menu

This repo has a wiki! You can check it by clicking here here.

🔧 Setup

This is step-by-step how to install these dotfiles. Just R.T.F.M.

1. Install Required Dependencies and Enable Services

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

Assuming your AUR Helper is paru.

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

paru -S awesome-git

Install necessary dependencies

paru -Sy picom-git wezterm rofi acpi acpid acpi_call upower lxappearance-gtk3 \
jq inotify-tools polkit-gnome xdotool xclip gpick ffmpeg blueman redshift \
pipewire pipewire-alsa pipewire-pulse pamixer brightnessctl feh scrot \
mpv mpd mpc mpdris2 python-mutagen ncmpcpp playerctl --needed

Enable Services

systemctl --user enable mpd.service
systemctl --user start mpd.service
2. Install My AwesomeWM Dotfiles

Clone this repository

git clone --depth 1 --recurse-submodules
cd dotfiles && git submodule update --remote --merge

Copy config files

cp -r config/* ~/.config/

Install a few fonts (mainly icon fonts) in order for text and icons to be rendered properly.

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

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

fc-cache -v

Finally, now you can login with AwesomeWM

Congratulations, at this point you have installed this aesthetic dotfiles! 🎉

Log out from your current desktop session and log in into AwesomeWM

🍀 Miscellaneous

GTK Theme

🌌 Aesthetic-Night gtk theme


  1. Copy the themes to the themes folders
    sudo cp -rf misc/themes/Aesthetic-Night/* /usr/share/themes
    cp -rf misc/themes/Aesthetic-Night-GTK4/* ~/.config/gtk-4.0
  2. Add this line on ~/.config/gtk-3.0/settings.ini for left controls

To apply the theme use lxappearance lxappearance-gtk3

VSCode Theme
VSCode theme preview

Aesthetic VSCode


  1. Install required extension

    note: You can use any themes, but some of the colors will be overwritten by mine

  2. copy config file

    cp misc/vscode/User/settings.json ~/.config/Code/User
Neovim Theme
neovim theme preview

🌀 Aesthetic Neovim

This is nvchad's port of my aesthetic theme named rxyhn

To get this theme you have to use nvchad as your neovim config, and then apply my theme.

Firefox Theme
firefox theme preview

Aesthetic Firefox


  1. Go to about:config in Firefox.
  2. Search for toolkit.legacyUserProfileCustomizations.stylesheets and set it to true.
  3. move the contents from misc/firefox to $HOME/.mozilla/firefox/xxxxxxxx.default-release/chrome.
Touchpad tap-to-click & natural (reverse) scrolling (libinput)


Section "InputClass"
    Identifier "touchpad"
    Driver "libinput"
    MatchIsTouchpad "on"
    Option "Tapping" "on"
    Option "TappingButtonMap" "lmr"
    Option "NaturalScrolling" "true"

🎨 Colorscheme

colorscheme preview

Introducing the Aesthetic Night colorscheme!

Beautiful and elegant color scheme, perfect for programmers who live in the middle of the night.

With the neat color combination that it can keep the eyes from getting tired! so you can keep writing code and continue all your work all night!

This colorscheme is used for all aspects in these dotfiles, yeeaaaah this aesthetic dotfiles is combined with an aesthetic colorscheme <3

This colorscheme was made by ner0z and modified by me rxyhn



#E5E5E5 #D9D7D6 #000A0E #061115 #0D181C #131E22


#1C252C #DF5B61 #78B892 #DE8F78 #6791C9 #BC83E3 #67AFC1


#484E5B #F16269 #8CD7AA #E9967E #79AAEB #C488EC #7ACFE4
! special
*.foreground:   #d9d7d6
*.background:   #061115

! black
*.color0:       #1c252c
*.color8:       #484e5b

! red
*.color1:       #df5b61
*.color9:       #f16269

! green
*.color2:       #78b892
*.color10:      #8cd7aa

! yellow
*.color3:       #de8f78
*.color11:      #e9967e

! blue
*.color4:       #6791c9
*.color12:      #79aaeb

! magenta
*.color5:       #bc83e3
*.color13:      #c488ec

! cyan
*.color6:       #67afc1
*.color14:      #7acfe4

! white
*.color7:       #d9d7d6
*.color15:      #e5e5e5
Modern Bottom Panel with Animation
bottom panel preview
Aesthetic Dashboard with neat grid layout
dashboard preview
Good looking Info Center
info center preview
Beautiful Notification Center
notification center preview
Naughty Notifications
notifications preview
Custom mouse-friendly ncmpcpp UI
ncmpcpp preview
Lockscreen with PAM Integration
word clock lockscreen preview
Minimalist Exitscreen
exitscreen preview

🗾 History

Ngl this is started when im feel bored lol and decided to start using Linux, more precisely in January 2022. When it's in Linuxer Desktop Art i saw a linux setup that caught my eye, then I'm interested in and trying something similar, So yeaaaaaah this is my current setup, I made this with all Aesthetic I have. Yes! you're right! everything you see here is all about beautiful and aesthetic, and ofc apart from targeting the beautiful UI I also pay attention to the functionality, because I'm targeting an OS that's comfortable to wear and look at. Have a Nice Day! <3

I wanna say thank you to those of you who like and love my setup <3


I've ko-fi account, So if you enjoyed it and would like to show your appreciation, you may want to tip me here.

It is never required but always appreciated.

Thanks from the bottom of my heart! 💗

💡 Acknowledgements