Skip to content

saimoomedits/dotfiles

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

82 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

The Arch Linux & AwesomeWM dotfiles!

Features Β· Setup Β· Keys Β· Mods Β· Wiki


Welcome


If you like this setup, please drop a star.
I really appreciate it. Thanks!

Hi there, thanks for dropping by πŸ’™,

these are my Arch Linux and AwesomeWM configuration files.

You can use this repository as a rice reference.

Or use them as a daily driver.


Setup Info


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-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 252
      • either, comment it out or remove that line
      • this will disable rounded windows with awesomeWM




features


  • Control Center
  • Vertical Bar
  • Brightness / Volume OSD
  • Lockscreen
  • Tasklist Dock
  • Light/Dark gtk and zathura theme
  • Minimal exitscreen
  • Control state saver
  • Better Ncmpcpp ui
  • Battery notifier
  • And many more!

Show previews
  • minimalstic vertical bar



  • expandable control center



  • Minimal notifcations with text actions



  • custom ncmpcpp UI



  • exit screen



  • lockscreen



  • Minimal tasklist dock with pinned apps



  • Wip vscode theme






Setup


Instructions

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


  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 mpdris2 bluez bluez-utils bluez-plugins acpi acpi_call \
    playerctl redshift cutefish-cursor-themes-git cutefish-icons upower xorg xorg-init tar
  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 --recurse-submodules https://github.com/saimoomedits/dotfiles.git
    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
  5. Extract Gtk-theme

    mkdir ~/.themes
    cp ./themes/* ~/.themes
    cd ~/.themes
    tar -xf Awesthetic.tar
    tar -xf Cutefish-light-modified.tar
    rm Awesthetic.tar Cutefish-light-modified.tar
  6. make some files executeable

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

    systemctl --user enable mpd
    sudo systemctl enable bluetooth
  8. Done

    • if your already logged into awesome, reload it
    • else, Login to AwesomeWM

Enjoy πŸ˜„


  • Vscode theme
    • copy extras/vscode-theme/Awesthetic to ~/.vscode/extentions/.
    • now, in VScode, open the Color Theme picker with File > Preferences > Color Theme.
    • select Awesthetic theme.



Keybinds


  • you can get a list of keybindings here in the wiki.
  • the dock can be opened by hovering bottom edge of primary screen
  • the control-Center can either be opened by keybinding super(windows key) + a or
    by click on the control center icon in bar



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. Upower battery

    • Created by Aire-One
    • A UPowerGlib based battery widget for the AwesomeWM.
  5. Awesome-Dock

    • Created by me....
    • A tasklist dock with pinned apps
    • you can use it in your config (hopefully)
    • but there are still lots of things to improve

    More info
    • you can use this dock in your awesome config. but...

    • 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




  • contributers