aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorJoe <rbo@gmx.us>2024-12-19 15:06:27 +0100
committerJoe <rbo@gmx.us>2024-12-19 15:06:27 +0100
commit03765f41f101502e9825047419fa9d8667e710ea (patch)
treecef6445d9c3df3081aed9f8cd28555ecfd88e401 /README
parentconflict (diff)
downloaddwm-03765f41f101502e9825047419fa9d8667e710ea.tar.gz
dwm-03765f41f101502e9825047419fa9d8667e710ea.tar.bz2
dwm-03765f41f101502e9825047419fa9d8667e710ea.tar.xz
dwm-03765f41f101502e9825047419fa9d8667e710ea.tar.zst
dwm-03765f41f101502e9825047419fa9d8667e710ea.zip
6.5
Diffstat (limited to 'README')
-rw-r--r--README113
1 files changed, 43 insertions, 70 deletions
diff --git a/README b/README
index 7876e76..95d4fd0 100644
--- a/README
+++ b/README
@@ -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.