diff options
author | Joe <rbo@gmx.us> | 2024-12-19 15:06:27 +0100 |
---|---|---|
committer | Joe <rbo@gmx.us> | 2024-12-19 15:06:27 +0100 |
commit | 03765f41f101502e9825047419fa9d8667e710ea (patch) | |
tree | cef6445d9c3df3081aed9f8cd28555ecfd88e401 /README | |
parent | conflict (diff) | |
download | dwm-03765f41f101502e9825047419fa9d8667e710ea.tar.gz dwm-03765f41f101502e9825047419fa9d8667e710ea.tar.bz2 dwm-03765f41f101502e9825047419fa9d8667e710ea.tar.xz dwm-03765f41f101502e9825047419fa9d8667e710ea.tar.zst dwm-03765f41f101502e9825047419fa9d8667e710ea.zip |
6.5
Diffstat (limited to '')
-rw-r--r-- | README | 113 | ||||
-rw-r--r-- | README.org | 72 |
2 files changed, 43 insertions, 142 deletions
@@ -1,75 +1,48 @@ -Joe's dwm (the dynamic window manager) build -The original dwm build I used to run. Based on version 6.2. +dwm - dynamic window manager +============================ +dwm is an extremely fast, small, and dynamic window manager for X. -Dependencies + +Requirements ------------ - Required: - --------- - - A C compiler - - make - - xorg - - libX11 - - libXft - - Optional: - --------- - - st - - dmenu +In order to build dwm you need the Xlib header files. + Installation ------------ -To install this open a terminal and run these commands: - - $ git clone git://jozanleclerc.xyz/jozan/dwm.git - $ cd dwm - $ make - # make install clean - -To use it as a default WM, if you are using xinit, add this to your .xinitrc: - exec dwm - -Bindings --------- -Some of the main key bindings: - - switch to workspace 1-12 with super+{F1-F12} - - move selected stack to workspace 1-12 with super+shift+{F1-F12} - - fire up st terminal with super+return - - kill selected stack with super+q - - cycle through stacks down/up with super+j/k - - move selected stack down/up with super+shift+j/k - - resize master stack to left/right with super+h/l - - invoke dmenu_run application launcher with super+p - - toggle better tiled mode with super+s - - toggle alternative tiled mode with super+shift+s - - toggle normal tiled mode with super+t - - toggle fullscreen mode on selected stack with super+f - - toggle floating mode on selected stack with super+space - - toggle top bar with super+b. Hidden by default - - restart dwm with super+shift+r - - exit dwm with super+shift+e - -Patches -------- -List of patches in use: - - actualfullscreen - - alwayscenter - - alwaysfullscreen - - attachasideandbelow - - centeredmaster - - fibonacci - - focusonclick - - nmaster - - moveresize - - movestack - - noborder - - nodmenu - - pertag - - restartsig - - savefloats - - sizehints - - switchtotag - - tagothermon - -My own autostart script can be found under my dotfiles-bsd repository: -https://git.jozanleclerc.xyz/jozan/dotfiles-bsd/files.html -It should be placed in ~/.config/dwm directory. +Edit config.mk to match your local setup (dwm is installed into +the /usr/local namespace by default). + +Afterwards enter the following command to build and install dwm (if +necessary as root): + + make clean install + + +Running dwm +----------- +Add the following line to your .xinitrc to start dwm using startx: + + exec dwm + +In order to connect dwm to a specific display, make sure that +the DISPLAY environment variable is set correctly, e.g.: + + DISPLAY=foo.bar:1 exec dwm + +(This will start dwm on display :1 of the host foo.bar.) + +In order to display status info in the bar, you can do something +like this in your .xinitrc: + + while xsetroot -name "`date` `uptime | sed 's/.*,//'`" + do + sleep 1 + done & + exec dwm + + +Configuration +------------- +The configuration of dwm is done by creating a custom config.h +and (re)compiling the source code. diff --git a/README.org b/README.org deleted file mode 100644 index 343e089..0000000 --- a/README.org +++ /dev/null @@ -1,72 +0,0 @@ -#+TITLE: Joe's dwm (the dynamic window manager) build -The original [[https://dwm.suckless.org/][dwm]] build I used to run. Based on version 6.2. - -* Dependencies -** Required: - - A C Compiler - - ~make~ - - ~xorg~ - - ~libX11~ - - ~libXft~ - -** Optional: - - ~st~ find my custom improved build [[https://github.com/JozanLeClerc/st][here]] - - ~dmenu~ - -* Installation -To install this open a terminal and run these commands: -#+BEGIN_SRC shell -git clone git://jozanleclerc.xyz/jozan/dwm.git -cd dwm -make -make install clean -#+END_SRC -To use it as a default WM, if you are using xinit, add this to your ~.xinitrc~: -#+BEGIN_SRC shell -exec dwm -#+END_SRC -I am not shure about how to set it up on regular desktop managers like ~gdm~ or ~lightdm~. - -* Bindings -Some of the main key bindings: -- *switch* to workspace 1-12 with ~super+{F1-F12}~ -- *move* selected stack to workspace 1-12 with ~super+shift+{F1-F12}~ -- *fire up* ~st~ terminal with ~super+return~ -- *kill* selected stack with ~super+q~ -- *cycle through* stacks down/up with ~super+j/k~ -- *move* selected stack down/up with ~super+shift+j/k~ -- *resize* master stack to left/right with ~super+h/l~ -- *invoke* ~dmenu_run~ application launcher with ~super+p~. Get it [[https://tools.suckless.org/dmenu/][here]] -- toggle *better tiled mode* with ~super+s~ -- toggle *alternative tiled mode* with ~super+shift+s~ -- toggle *normal tiled mode* with ~super+t~ -- toggle *fullscreen mode* on selected stack with ~super+f~ -- toggle *floating mode* on selected stack with ~super+space~ -- toggle *top bar* with ~super+b~. Hidden by default -- *restart* dwm with ~super+shift+r~ -- *exit* dwm with ~super+shift+e~ - -* Patches -List of patches in use: -- /actualfullscreen/ -- /alwayscenter/ -- /alwaysfullscreen/ -- /attachasideandbelow/ -- /centeredmaster/ -- /fibonacci/ -- /focusonclick/ -- /nmaster/ -- /moveresize/ -- /movestack/ -- /noborder/ -- /nodmenu/ -- /pertag/ -- /restartsig/ -- /savefloats/ -- /sizehints/ -- /switchtotag/ -- /tagothermon/ - -My own autostart script can be found under my -[[https://git.jozanleclerc.xyz/jozan/dotfiles-bsd/files.html][dotfiles-bsd]] repository. It should -be placed in =~/.config/dwm= directory. |