DWM is a lightweight and dynamic window manager based on X11. It is minimalistic, efficient, and designed to be customized by editing its source code. ✨

 
 Dependencies 
     
 Fonts 
     
 Wallpapers 
     
 Configs 
     
 Tmux 
     
 Picom 
     
 Systray 
     
 SDDM 
     
 Grub 
     
 DWM 
     
 Contributing 
 

Note

This guide features DWM patches from Chris Titus Tech, tweaked to suit my personal workflow while remaining simple for anyone to use.

🚀 Dependencies

Arch Linux

sudo pacman -S --needed --noconfirm base-devel libx11 libxinerama libxft imlib2 libxcb git unzip flameshot lxappearance feh mate-polkit meson libev uthash libconfig meson ninja gnome-keyring

Debian/Ubuntu

sudo apt install -y build-essential libx11-dev libxinerama-dev libxft-dev libimlib2-dev libx11-xcb-dev libfontconfig1 libx11-6 libxft2 libxinerama1 libxcb-res0-dev git unzip flameshot lxappearance feh mate-polkit meson ninja-build gnome-keyring

Fedora

sudo dnf install -y libX11-devel libXinerama-devel libXft-devel imlib2-devel libxcb-devel unzip flameshot lxappearance feh mate-polkit meson ninja-build gnome-keyring

openSUSE

sudo zypper install libX11-devel libXinerama-devel libXft-devel imlib2-devel libxcb-devel unzip flameshot lxappearance feh mate-polkit meson ninja-build gnome-keyring

🔠 Nerd Fonts

Why Nerd Fonts?

Nerd Fonts enhance font rendering and ensure proper alignment of icons in slstatus. For this setup, the MesloLGS Nerd Font is recommended.

✨ Installation

Arch Linux

sudo pacman -S --needed --noconfirm ttf-meslo-nerd noto-fonts-emoji ttf-joypixels

Other Distributions

• Download from: nerdfonts.com
• Place the font files in ~/.fonts or ~/.local/share/fonts.
• Refresh font cache:

  fc-cache -vf

🎨 Wallpapers

Directory Setup

Store wallpapers in ~/Pictures/wallpapers. Use the following command to clone a curated wallpaper collection:

git clone https://github.com/harilvfs/wallpapers ~/Pictures

⚙️ Configuration Files

Preconfigured package settings are included in this repository under the config folder. These settings enhance the DWM experience and can be installed based on your workflow and distribution.

Steps to Install Configurations

• Install the necessary packages for your distribution.
• Copy the preconfigured files to your ~/.config directory.

Package Installation by Distribution

Arch Linux

sudo pacman -S --needed --noconfirm kitty alacritty kvantum dunst fastfetch fish helix neovim picom rofi starship bash zsh

• BetterDiscord: Install as an AppImage or via AUR using paru or yay.

  yay -S betterdiscord-installer

Fedora

sudo dnf install kitty alacritty kvantum dunst fastfetch fish helix neovim picom rofi bash zsh

• Starship: Install using the official script:

  curl -sS https://starship.rs/install.sh | sh

• BetterDiscord: Download the AppImage from the official website.

Debian/Ubuntu

sudo apt install -y kitty alacritty qt5-style-kvantum fish neovim rofi dunst picom bash zsh

• Fastfetch: Download the appropriate .deb package from Fastfetch's release page and install it:

  sudo dpkg -i fastfetch-linux-<architecture>.deb

• Helix: Install from source using the Helix documentation.
• BetterDiscord: Download the AppImage from the official website.
• Starship: Install using the official script:

  curl -sS https://starship.rs/install.sh | sh

openSUSE

sudo zypper install kitty alacritty kvantum-manager fish neovim rofi fastfetch dunst picom starship bash zsh

• BetterDiscord: Download the AppImage from the official website.

Using Preconfigured Files

Once the required packages are installed, copy the preconfigured files to your .config directory:

cp -r config/* ~/.config/

Important

If you don’t have a preconfigured setup, it’s recommended to use the provided configurations for better compatibility with the DWM patches.

Tmux Setup

Install Tmux for terminal multiplexing.

Installation Commands

Arch Linux

sudo pacman -S tmux

Debian/Ubuntu

sudo apt install tmux

Fedora

sudo dnf install tmux

openSUSE

sudo zypper install tmux

Clone Tmux Plugin Manager [TPM]

git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

Configuration

Create the configuration directory:

mkdir ~/.config/tmux

Download the tmux configuration file:

wget -O ~/.config/tmux/tmux.conf https://raw.githubusercontent.com/harilvfs/dwm/refs/heads/main/config/tmux/tmux.conf

Install Plugins

cd ~/.tmux/plugin/tpm/scripts/
chmod +x install_plugins.sh
./install_plugins.sh

Install TPM

cd ~/.tmux/plugins/tpm
chmod +x tpm
./tpm

Update Plugins

cd ~/.tmux/plugin/tpm/scripts/
chmod +x update_plugin.sh
./update_plugin.sh

⚡ Picom Configuration

Picom provides window transparency and animations.

• Config File: Picom Config
• Animations: Check out FT-LABS.

🖥️ System Tray Icons

Install system tray applets for network, Bluetooth, and sound management.

• Packages:
  Install the necessary packages for your distribution:

Arch Linux

sudo pacman -S --needed --noconfirm network-manager-applet blueman pasystray

Fedora

sudo dnf install network-manager-applet blueman pasystray

Debian/Ubuntu

sudo apt install network-manager-applet blueman pasystray

openSUSE

sudo zypper install NetworkManager-applet blueman pasystray

Notes 📜 : For other distributions, refer to the respective package manager documentation.

✨ SDDM Theme

The setup uses the Astronaut Theme for SDDM.

• Installation:
  Clone the theme repository and follow the instructions to install:
  Keyitdev/sddm-astronaut-theme

🌌 GRUB Theme [OPTIONAL]

Customize your bootloader appearance with GRUB themes.

• Explore themes from ChrisTitusTech's repository:
  Top-5-Bootloader-Themes

Note: Ensure GRUB customization aligns with your workflow and is applied carefully to avoid bootloader issues.

🛠 Installation Script

For a simplified setup process, run the script:

bash <(curl -L https://raw.githubusercontent.com/harilvfs/dwm/refs/heads/main/setup.sh)

Note

This script is optimized for Arch Linux. Manual installation is recommended for other distributions or customized setups.

🔧 DWM Installation

Clone and install DWM:

git clone https://github.com/harilvfs/dwm ~/
cd ~/dwm
sudo make clean install

Install slstatus

cd ~/dwm/slstatus
sudo make clean install

Add this to your ~/.xinitrc

exec dwm &
slstatus

Important

After installation, remember to adjust some keybindings in config.h to fit your use case.

Note

Default keybinding for terminal is mod + x and for rofi is mod + r.

🎉 Result

Enjoy your minimalist and customized DWM setup!

Note: Some distributions may require additional dependencies or configuration.Feel free to explore your distribution’s community for guidance on missing dependencies.

🛠️ Contributing

For more detailed contribution guidelines, please check our CONTRIBUTING.md.

🤝 Code of Conduct

We aim for a welcoming environment for all contributors. Please read our Code of Conduct for a better experience.

📬 Contact

For questions or suggestions, feel free to reach out via:

• 📧 Email: [email protected]

🌟 Contributors

Thank you to all contributors! Your efforts and input are truly invaluable. 💖