dotfiles | There is no place like ~/ | Configuration Management library

Here are the instructions you should follow to replicate my AwesomeWM setup.
Install the git version of AwesomeWM. Arch users can use the awesome-git AUR package. yay -S awesome-git For other distros, build instructions are here.
Install dependencies and enable services If you are curious, click here to see a table of dependencies and why they are needed. Software Ubuntu 18.04 or newer (and all Ubuntu-based distributions) sudo apt install rofi lm-sensors acpid jq fortune-mod redshift mpd mpc maim feh pulseaudio inotify-tools xdotool # Install light, which is not in the official Ubuntu repositories wget https://github.com/haikarainen/light/releases/download/v1.2/light_1.2_amd64.deb sudo dpkg -i light_1.2_amd64.deb Arch Linux (and all Arch-based distributions) Assuming your AUR helper is yay yay -S rofi lm_sensors acpid jq fortune-mod redshift mpd mpc maim feh light-git pulseaudio inotify-tools xdotool Services # For automatically launching mpd on login systemctl --user enable mpd.service systemctl --user start mpd.service # For charger plug/unplug events (if you have a battery) sudo systemctl enable acpid.service sudo systemctl start acpid.service
Install needed fonts You will need to install a few fonts (mainly icon fonts) in order for text and icons to be rendered properly. Necessary fonts: Typicons - github Material Design Icons - dropbox Icomoon - dropbox Nerd Fonts - website (You only need to pick and download one Nerd Font. They all include the same icons) Scriptina - website - Handwritten font used in the lock screen Optional fonts: My custom Iosevka build - dropbox - 💙 my favorite monospace font Anka/Coder Google Sans - 💙 my favorite sans font Roboto Condensed San Francisco Display Once you download them and unpack them, place them into ~/.fonts or ~/.local/share/fonts. You will need to create the directory if it does not exist. It does not matter that the actual font files (.ttf) are deep inside multiple directories. They will be detected as long as they can be accessed from ~/.fonts or ~/.local/share/fonts. You can find the fonts required inside the misc/fonts folder of the repository. cp -r ./misc/fonts/* ~/.fonts/ # Or to ~/.local/share/fonts cp -r ./misc/fonts/* ~/.local/share/fonts/ Finally, run the following in order for your system to detect the newly installed fonts. fc-cache -v
Install my AwesomeWM configuration files git clone https://github.com/elenapan/dotfiles cd dotfiles [ -e ~/.config/awesome ] && mv ~/.config/awesome ~/.config/awesome-backup-"$(date +%Y.%m.%d-%H.%M.%S)" # Backup current configuration cp -r config/awesome ~/.config/awesome
Configure stuff The relevant files are inside your ~/.config/awesome directory. User preferences and default applications In rc.lua there is a User variables and preferences section where user preferences and default applications are defined. You should change those to your liking. Probably the most important change you can make is to set your terminal. For more sophisticated control over your apps, check out apps.lua Note: For the weather widgets to work, you will also need to create an account on openweathermap, get your key, look for your city ID, and set openweathermap_key and openweathermap_city_id accordingly. Have a general idea of what my keybinds do My keybinds will most probably not suit you completely, but on your first login you might need to know how to navigate the desktop. See the keybinds section for more details. You can edit keys.lua to configure your keybinds. (Optional) This is also a good time to take a look at how my configuration is structured in order to understand the purpose of each file.
Login with AwesomeWM 🎉 Congratulations, at this point you should be ready to log out of your current desktop and into AwesomeWM. Your login screen should have a button that lets you change between available desktop sessions. If not, click here to find out how to fix it. Try it, play with it, enjoy it. Consider checking out the Advanced setup in order to enable and configure various components that are not needed to use the desktop, but provide a better experience.
(Optional) Eye-candy Set the wallpaper feh --bg-fill /path/to/your/wallpaper Load a colorscheme xrdb -merge /path/to/colorscheme Notes: To see the new colors you should restart AwesomeWM with super+shift+r or by right-clicking the desktop and clicking the gear icon (bottom-right). In the .xfiles directory of the repository I provide you with a few of my own colorschemes, but you can also use your favorite one. All of my AwesomeWM themes take their colors from xrdb. This also means that they play nice with tools like pywal.