hello there, welcome to my Awesomewm dotfiles!
this an awesomewm rice/setup that I use as a daily driver.

🫂 you can take anything you like from this repository. but.. please credit me too! 😄

⭐ if you liked it, please star this repo, it really helps me ⭐

Info - Gallery - Features - Setup - Keys - Mods

info 📖

setup details

task	name
WM	awesome-git
terminal	alacritty
music player	mpd & ncmpcpp
Light GTK theme	Cutefish-light
Dark Gtk theme	Awesthetic-gtk
bar	wibar
compositor	picom-ibhagwan-git

more info 🕵️

• Fonts?
  • as for fonts, the setup uses 4 fonts in total
    • Roboto - main ui font
    • Material Icons - for icons
    • Iosevka - Terminal/Monospace font
    • JetbrainsMono NF - idk

• gaps/border/titlebar
  • titlebars
    • you can edit layout/decorations/init.lua to emend/modify the global titlebar.
  • borders
    • border size can be change in theme/ui_vars.lua, there is a border_size.
  • gaps
    • Gaps can also be changed in theme/ui_vars.lua.

• custom theme?
  • for dark, edit theme/colors/dark.lua
  • for light, edit theme/colors/light.lua

• rounded corners

  • by default, windows are rounded with awesome-wm's client.shape property,

  • if you want to use picom instead, do the following,

    • edit config/others.lua
    • scroll down to line 256
    • either, comment it out or remove that line
    • this will disable rounded windows with awesomeWM

shots gallery 📸

1. dark themed

   
   

2. light themed

   
   

features 💡

1. minimalstic vertical bar

   
   

2. expandable control center

   
   

3. Minimal notifcations with text actions

   
   

4. custom ncmpcpp UI

   
   

5. exit screen

   
   

6. lockscreen

   
   

6. Minimal tasklist dock with pinned apps

   
   

and much more, obviously lol

setup 👀

NOTE: The following instructions are for Arch/Arch-based system

Instructions

1. Install packages / dependencies

   yay -S picom-git awesome-git acpid git mpd ncmpcpp wmctrl \
   firefox lxappearance gucharmap thunar alacritty neovim polkit-gnome \
   xdotool xclip scrot brightnessctl alsa-utils pulseaudio jq acpi rofi \
   inotify-tools zsh materia-gtk-theme mpdris2 bluez bluez-utils bluez-plugins \
   playerctl redshift cutefish-cursor-themes-git cutefish-icons
   

2. Make backup of directories that will be changed (optional)

   cd 
   mkdir .backup_config
   cp -r ~/.config/* .backup_config/
   cp -r ~/.mpd .backup_config/
   cp -r ~/.ncmpcpp .backup_config/
   cp -r ~/.themes .backup_config/
   

3. Clone this repo

   cd
   clear
   git clone https://github.com/saimoomedits/dotfiles
   cd dotfiles
   

4. Copy the dotfiles in required places

   cp -rf .config/* ~/.config/
   cp -rf extras/mpd ~/.mpd
   cp -rf extras/ncmpcpp ~/.ncmpcpp
   cp -rf extras/fonts ~/.fonts
   cp -rf extras/scripts ~/.scripts
   cp -rf extras/oh-my-zsh ~/.oh-my-zsh
   cp -rf extras/themes ~/.themes/
   

5. make some files executeable

   cd ~/.config/awesome/misc
   sudo chmod -R +x *
   

6. Startup services

   systemctl --user enable mpd
   sudo systemctl enable bluetooth
   

7. Done

   All done, Now login to awesome-WM

Keybinds

• press super(windows key) + f1 😄
• the dock can be opened by hovering bottom of the screen
• the dashboard/notifcenter can be opened by hovering to the right for 0.24 seconds

Modules

1. Rubato

   • Created by andOrlando
   • Basically, Allows you to animate a number value in AwesomeWM

2. Bling

   • Created by the BlingCorp community
   • Adds a lot more cool modules to AwesomeWM

3. Layout-machi

   • Created by xinhaoyuan
   • Manual layout with interactive editor

4. Awesome-Dock

   • Created by me. the idiot

   • A tasklist dock with pinned apps

   • you can use it in your config (hopefully)

   • but there are still lots of things to improve

     • The dock can be used in any awesome rice.. (kinda) the catch is that. you need a spcific icon-theme in /usr/share/icons for pinned apps to work properly
       but if your using the exact rice as mine, you don't have to worry about it
   
   
   • You can customize the dock's colors, size, spacing, hide-timeout, etc in theme/init.lua
   
   
   • example:

   theme.awesome_dock_size = 80
   theme.awesome_dock_pinned = {
       {"xterm", "terminal"},
       {"spotify", "spotify"},
       {"xterm"},
       {"thunar"}
   }
   theme.awesome_dock_color_active = theme.accent
   theme.awesome_dock_color_inactive = theme.fg_color .. "66"
   theme.awesome_dock_color_minimized = theme.accent .. "33"
   theme.awesome_dock_color_hover = theme.fg_color .. "33"
   theme.awesome_dock_color_bg = theme.bg_color
   theme.awesome_dock_disabled = false
   theme.awesome_dock_spacing = 10
   theme.awesome_dock_timeout = 1.2

   • to add more pinned apps you can do the following in theme.lua:

   --[[ 
       table example:
       { "app command", "app class"}
       
       * `app command` is well. the command that launches that app
       * `app class` is the class or name of the app for icons.
   ]]
   theme.awesome_dock_pinned = {
       {"spotify", "spotify"},
       {"xterm"},
       {"thunar"}
   }

Todos

• Make dock's icon-handler identify global icon-theme
• Improve Ncmpcpp decorations
• Improve Notifications
• Polish Awesthetic-gtk-theme

Credits

• special thanks to ❤️
  • moonlight-coffee
  • justleoo

• also these 🌃 awesome people!
  • Javacafe01
  • manilarome
  • elenapan

• extras ✨
  • the awesome team - awesomeWM contributers
  • Cutefish - Cutefishos
  • rubato - smooth animations
  • Bling - make awesome even more awesome

• contributers