diff --git a/README.md b/README.md index deb3cec..88078ff 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,16 @@ -dwm - dynamic window manager -============================ -dwm is an extremely fast, small, and dynamic window manager for X. +
+ dwm-logo-bordered + + # dwm - dynamic window manager + ### dwm is an extremely ***fast***, ***small***, and ***dynamic*** window manager for X. + +
+ +--- +This is my **Personal Fork** with following patches:
- This is my personal fork with following patches: + Click to see the list of patches - alwayscenter - alwaysfullscreen @@ -26,70 +33,95 @@ dwm is an extremely fast, small, and dynamic window manager for X. - warp v2 - winicon -❕ Some patches are rewritten or modified to work together. + **Note**: Some patches are rewritten or modified to work together.
-Prerequisites -------------- +## 📋 Prerequisites This guide assumes your system has the latest updates before going ahead with the installation. -Note that you may want to keep the source directories of the tools you download in a suitable location for future reference as you may need to recompile them to apply configuration changes. +> [!NOTE] +> You may want to keep the source directories of the tools you download in a suitable location for future reference as you may need to recompile them to apply configuration changes. -## arch -```sh -sudo pacman -S --needed base-devel extra/git extra/libx11 extra/libxcb extra/libxinerama extra/libxft extra/imlib2 -``` +
+ Arch -If you find yourself missing a library then this can usually be found by searching for the file name using pacman: -```sh -$ pacman -F Xlib-xcb.h -extra/libx11 1.6.12-1 [installed: 1.7.2-1] - usr/include/X11/Xlib-xcb.h + Install dependencies: -``` + ```sh + sudo pacman -S --needed base-devel extra/git extra/libx11 extra/libxcb extra/libxinerama extra/libxft extra/imlib2 + ``` -## Debian/Ubuntu -```sh -sudo apt install build-essential git libx11-dev libx11-xcb-dev libxcb-res0-dev libxinerama-dev libxft-dev libimlib2-dev -``` + If you find yourself missing a library then this can usually be found by searching for the file name using pacman: -It is worth checking the version of gcc on debian based systems as they may come with older implementations that can result in compilation errors. -```sh -gcc --version -``` -You would expect at least v8.x or above here. + ```sh + $ pacman -F Xlib-xcb.h + extra/libx11 1.6.12-1 [installed: 1.7.2-1] + usr/include/X11/Xlib-xcb.h + ``` -If you find yourself missing a library then this can usually be found by searching for the file name using apt-file, a tool that have to be installed separately: -```sh -$ sudo apt install apt-file -$ sudo apt-file update -$ apt-file search xcb/res.h -libxcb-res0-dev: /usr/include/xcb/res.h -``` +
-## Void Linux -```sh -sudo xbps-install -Su base-devel libX11-devel libXft-devel libXinerama-devel freetype-devel fontconfig-devel libxcb-devel imlib2-devel -``` +
+ Debian/Ubuntu + + Install dependencies: + + ```sh + sudo apt install build-essential git libx11-dev libx11-xcb-dev libxcb-res0-dev libxinerama-dev libxft-dev libimlib2-dev + ``` + + It is worth checking the version of gcc on debian based systems as they may come with older implementations that can result in compilation errors. + + ```sh + gcc --version + ``` + + You would expect at least v8.x or above here. + + If you find yourself missing a library then this can usually be found by searching for the file name using apt-file, a tool that have to be installed separately: + + ```sh + $ sudo apt install apt-file + $ sudo apt-file update + $ apt-file search xcb/res.h + libxcb-res0-dev: /usr/include/xcb/res.h + ``` + +
-If you find yourself missing a library then this can usually be found by searching for the file name using xlocate, a tool that have to be installed separately via the xtools package: -```sh -$ xlocate yajl/yajl_gen.h -yajl-devel-2.1.0._4 /usr/include/yajl/yajl_gen.h -``` -Installation ------------- +
+ Void Linux + + Install dependencies: + + ```sh + sudo xbps-install -Su base-devel libX11-devel libXft-devel libXinerama-devel freetype-devel fontconfig-devel libxcb-devel imlib2-devel + ``` + + If you find yourself missing a library then this can usually be found by searching for the file name using xlocate, a tool that have to be installed separately via the xtools package: + + ```sh + $ xlocate yajl/yajl_gen.h + yajl-devel-2.1.0._4 /usr/include/yajl/yajl_gen.h + ``` + +
+ +## 🛠️ Installation Clone the repository, then compile and install. + ```sh -$ git clone https://github.com/ChrisTitusTech/dwm-titus.git -$ cd dwm-titus -$ make -$ sudo make install +git clone https://github.com/ChrisTitusTech/dwm-titus.git && \ +cd dwm-titus && \ +make && \ +sudo make install ``` -A dwm.desktop file will be placed in /usr/share/xsessions/ so if you are using a login manager you should now be able to select dwm as the window manager when logging in. +- A dwm.desktop file will be placed in `/usr/share/xsessions/` so if you are using a login manager you should now be able to select dwm as the window manager when logging in. -If you do not use a login manager then you already know what you are doing. Add exec dwm at the end of your ~/.xinitrc file. +- If you do not use a login manager then you already know what you are doing. Add `exec dwm` at the end of your `~/.xinitrc` file. -By default new terminals are opened by using the keyboard shortcut of Super+x while rofi is started using Super+r. +> [!TIP] +> - By default new terminals are opened by using the keyboard shortcut of SUPER + X while rofi is started using SUPER+R +> - Check `config.h` for the keybindings, and change them according to your preference. diff --git a/dwm-logo-bordered.png b/dwm-logo-bordered.png new file mode 100644 index 0000000..af92ac1 Binary files /dev/null and b/dwm-logo-bordered.png differ diff --git a/dwm.png b/dwm.png deleted file mode 100644 index b1f9ba7..0000000 Binary files a/dwm.png and /dev/null differ