Skip to content
/ pdwm Public

full animation supported, easy configurable (uses shared library) dwm fork with a control center (pdwmc)

License

Notifications You must be signed in to change notification settings

FT-Labs/pdwm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

alt text alt text

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 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.

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/$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

Running:

Simply run startx from tty, or use a display manager. Desktop file is automatically made and installed.

NOTE: Caps Lock == Win

NOTE: Caps Lock is also equal to ESC in terminal (vim etc..)

Program Keys (man dwm will work too, or try keys sheet):

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

Terminal keybinds

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

Window Movement

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

Layouts

You can Right Click RMB on ' []= ' in status bar to choose layout with mouse

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

Tag operations

You can Left Click LMB on 1-9 in status bar to focus tag

You can Right Click RMB on 1-9 in status bar to select multiple tags

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

Utility keys

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

Mouse actions

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