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.
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.
(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')
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
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 application
If 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.
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/$arch
After 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 phyOS
Now 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
Simply run startx from tty, or use a display manager. Desktop file is automatically made and installed.
| Key Combination | Action |
|---|---|
| Win + q | Quit focused |
| Win + Return | Terminal(st) |
| Win + ESC | Power menu |
| Win + Shift + Return | Scratchpad (Terminal) [Press again to toggle] |
| Win + w | $BROWSER(default ungoogled chromium) |
| Win + r | File Browser (lf) |
| Win + a | Execute Applications (rofi) |
| Win + b | Toggle status bar (hide) |
| Win + d | Jump to directory with terminal (check 'bm' script to add bookmarks) |
| Win + Shift + a | Execute Any Runnable (dmenu) |
| Win + p | passmenu (pass password manager) |
| Alt + p | stress test and monitor (s-tui) |
| Win + F4 | pulsemixer (audio input) |
| Win + F5 | set multiple monitors and choose refresh rate |
| Win + F9 | mount drive |
| Win + F10 | unmount drive |
| Win + F11 | Camera |
| Win + Shift + s | Screenshot (choose area or screen) |
| Printscreen | Screenshot fullscreen |
| Shift + Printscreen | Screenshot (choose area or screen) |
| Win + ` | Choose emoji and copy |
| Key Combination | Action |
|---|---|
| Alt + Shift + j | Decrease font size (zoom -) |
| Alt + Shift + k | Increase font size (zoom +) |
| Alt + o | Copy output of command |
| Alt + ; | Cycle fonts |
| Key Combination | Action |
|---|---|
| Win + Tab | Choose window from current desktop |
| Alt + Tab | Choose any window and focus |
| Win + j | Focus next |
| Win + Shift + j | Move focused to next |
| Win + k | Focus previous |
| Win + Shift + k | Move focused to previous |
| Win + l | Resize master + |
| Win + Shift + h | Next Tag |
| Win + h | Resize master - |
| Win + Shift + h | Previous Tag |
| Win + s | Sticky window toggle (show window in all tags) |
| Win + f | Fullscreen (toggle) |
| Win + g | Toggle gaps |
| Win + x | Decrease gaps |
| Win + Shift + x | Increase gaps |
| Win + Shift + g | Set default gaps |
| Win + m | Increase master (just try it to understand) |
| Win + Shift + m | Decrease master (just try it to understand) |
| Win + Space | Set focused as master |
| Win + Shift + Space | Toggle floating window |
| Key Combination | Action |
|---|---|
| Alt + 1 | Tiling (Default) |
| Alt + 2 | Backstack |
| Alt + 3 | Monocle (windows top of each) |
| Alt + 4 | Deck layout |
| Alt + 5 | Spiral |
| Alt + 6 | Dwindle |
| Alt + 7 | Centered master |
| Alt + 8 | Centered floating master |
| Alt + 9 | Floating (windows 10 style) |
| Win + Right | Cycle layout next |
| Win + Left | Cycle layout previous |
| Key Combination | Action |
|---|---|
| Win + 1 .. 9 | Go to tag number |
| Win + WheelUp | Go to next tag |
| Win + WheelDown | Go to previous tag |
| Win + Shift + 1 .. 9 | Send focused window to tag number |
| Key Combination | Action |
|---|---|
| Sound Up | Increase sound |
| Sound Down | Decrease sound |
| Brightness Down | Decrease brightness |
| Brightness Up | Increase brightness |
| fn + TouchpadToggle | Toggle touchpad |
| fn + Kbd Backlight Up | Increase keyboard backlight |
| fn + Kbd Backlight Down | Decrease keyboard backlight |
| Key Combination | Action |
|---|---|
| RMB | Open Dropdown Menu (On Root Window) |
| Win + RMB | Open Dropdown Menu (On Any Client) |
| Win + LMB | Move window with mouse (sets window to floating mode) |
| Win + MMB | Resize window with mouse (sets window to floating mode) |
| Alt + LMB | Hide focused window (iconic state, restore it from dock) |
| Alt + RMB | Toggle dock |
