pdwm & phyOS-dwm
pdwm & phyOS-dwm are both suckless dwm forks. Both of them are in this repo, please read below to understand why. Also note that dwmblocks is embedded in this project, you don't need to download it from somewhere else.
For full animation support, please install phyOS-picom fork. Any other picom fork won't work.
phyOS-dwm is the oldest master branch of this project. This has been changed to pdwm branch. phyOS-dwm is just modified suckless dwm, with dwmblocks in it. Please note that this dwmblocks uses libconf library, which you can add/remove statusbar blocks with .cfg files. Also more than 10 statusbar blocks available for phyOS users. However, all of these can be installed on base arch linux too. Statusbar configuration can be made easily with pOS-make-bar script.
Settings button on top left (blue one) will open up a terminal application, which you can choose powermenu themes - colorschemes, and animation options from there. It also has some extra scripts in it to make your statusbar, choose sddm & grub themes.
Gifs
Screenshots
(Alt + Tab to switch windows)
(Hide and restore windows from bottom dock (Check keys for how to do this))
(catppuccin & tokyo night theme)
(Power menu 'right one is to renew dwm without restart')
Why the change? What is pdwm?
Originally, dwm configuration options are compiled into a single binary. Therefore, to be able to change any attribute you need to edit configuration file and recompile it into dwm again. With pdwm, this changes. Since dwm is supposed to be minimalistic and performant, simply putting a configuration library to handle these options doesn't make sense. It will increase SLOC a lot. To overcome this issue, another simple method has been made:
All of the configuration variables in dwm (nearly everything, except some edge cases) have been marked as extern variables. In pdwm folder, you can see all the configuration options. These options are made a shared library (.so). With this flexibility, and minor lines of code, at the execution stage of dwm, all of the variables are being loaded into dwm from an outside source, which is the shared library. This way, by just compiling the variables and renewing dwm, all options have been renewed. Without even using sudo.
Note that from now on, mostly pdwm will get updated. However, the older fork, phyOS-dwm is still available on master branch. This is much of a choice now, choose whatever you prefer.
The tool to configure dwm is a python program, which is called pdwmc. It is the main control center of pdwm.
Link: https://github.com/FT-Labs/pdwmc
pdwm Usage
IMPORTANT: Please extend your "LD_LIBRARY_PATH" to this location:
E.G: export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$HOME/.config/phyos/pdwm"
You must do this, because fallback library will be in /usr/lib. Your local configurations (.so) file will be stored here, and you must extend it to this place for linux ld linker to be able to see it.
As said before pdwm is a simple python program. It both has support for changing/printing any configuration options from terminal, or via QT app. Now lets get on with options.
usage: pdwmc [-h] [-w] [-b] [-g] [-s {appearance,buttons,keys,rules}]
[-c {appr,font,button,key,rule}] [-a {font,button,key,rule}]
[-d {font,button,key,rule}] [-q]
options:
-h, --help show this help message and exit
-w, --write Write current dwm configuration to edit [Use this before to
edit dwm configuration] or reset your changes
-b, --build Save changes to dwm
-g, --get Get default dwm settings (overrides current) to use pdwm,
also runs -w flag
-s {appearance,buttons,keys,rules}, --show {appearance,buttons,keys,rules}
-c {appr,font,button,key,rule}, --change {appr,font,button,key,rule}
Choose and change attribute
-a {font,button,key,rule}, --add {font,button,key,rule}
Add new attribute
-d {font,button,key,rule}, --delete {font,button,key,rule}
Delete an attribute
-q, --qt Run pdwm as a QT applicationIf you prefer a gui application, just run pdwmc -q. It is a simple and editable QT app, also catches your keypresses, which will save you some time from learning keysym's from internet. If key is not detected, simply find it from google and edit the key.
pdwmc screenshots
To be able to install these, please follow the steps below. Also if interested, you can download iso image to a vm, build it then update to system to be able to try.
These explanations are only for arch linux based distributions (any pacman using distro is okay). There are important dependencies, which I could not find all packages to fit all distributions. Later on a debian package version may come too.
Append package repo end of your /etc/pacman.conf :
[phyOS-repo]
SigLevel = Required DatabaseOptional
Server = https://FT-Labs.github.io/$repo/$archAfter adding the repo, install keyring first:
sudo pacman-key --recv-key 964FD85861C858D7
sudo pacman-key --lsign-key 964FD85861C858D7
sudo pacman -Syy phyOS-keyring
sudo pacman-key --init
sudo pacman-key --populate phyOSNow install necessary packages (This will install most of the phyOS packages, if you which packages to choose simply install them, this is a general guide):
sudo pacman -Syy
curl https://raw.githubusercontent.com/FT-Labs/phyOS-Aug-22/master/packages.x86_64 | sed -e '/\#/d' | tr -s "\n" | xargs sudo pacman -S --noconfirm
After the installation, please reboot your computer. Now you will need dotfiles, please move your current dots to somewhere else if they are important.
Run: phyup dots --force to get latest dotfiles. This is required to set your .xinitrc, .xprofile and picom options etc. correctly. Anyway, if you want you can just check dotfiles repo and choose whatever is required from there.
pdwm Packages: pdwm pdwmc
phyOS-dwm (classic compiled dwm) packages: phyOS-dwm
Running:
Simply run startx from tty, or use a display manager. Desktop file is automatically made and installed.