sites

mirror of git://git.suckless.org/sites
Log | Files | Refs

index.md (8056B)


      1 ![dwm](dwm.svg)
      2 
      3 dwm is a dynamic window manager for X. It manages windows in tiled,
      4 monocle and floating layouts. All of the layouts can be applied
      5 dynamically, optimising the environment for the application in use and
      6 the task performed.
      7 
      8 In tiled layout windows are managed in a master and stacking area. The
      9 master area contains the window which currently needs most attention,
     10 whereas the stacking area contains all other windows. In monocle layout
     11 all windows are maximised to the screen size. In floating layout windows
     12 can be resized and moved freely. Dialog windows are always managed
     13 floating, regardless of the layout applied.
     14 
     15 Windows are grouped by tags. Each window can be tagged with one or
     16 multiple tags. Selecting certain tags displays all windows with these
     17 tags.
     18 
     19 Each screen contains a small status bar which displays all available
     20 tags, the layout, the number of visible windows, the title of the
     21 focused window, and the text read from the root window name property,
     22 if the screen is focused. A floating window is indicated with an empty
     23 square and a maximised floating window is indicated with a filled
     24 square before the windows title.  The selected tags are indicated with
     25 a different color. The tags of the focused window are indicated with a
     26 filled square in the top left corner.  The tags which are applied to one
     27 or more windows are indicated with an empty square in the top left corner.
     28 
     29 dwm draws a small customizable border around windows to indicate the
     30 focus state.
     31 
     32 ->[![Screenshot](screenshots/dwm-20100318s.png)](screenshots/dwm-20100318.png)<-
     33 
     34 Differences
     35 -----------
     36 In contrast to ion, larswm, and wmii, dwm is much smaller, faster and simpler.
     37 
     38 * dwm has no Lua integration, no 9P support, no shell-based configuration, no remote control, and comes without any additional tools, such as for printing the selection or warping the mouse.
     39 * dwm is only a single binary, and its source code is intended to never exceed 2000 SLOC.
     40 * dwm doesn't distinguish between layers: there is no floating or tiled layer. Whether or not the clients of currently selected tag(s) are in tiled layout, you can rearrange them on the fly. Popup and fixed-size windows are always floating, however.
     41 * dwm is customized through editing its source code, which makes it extremely fast and secure - it does not process any input data which isn't known at compile time, except window titles and status text read from the root window's name. You don't have to learn Lua/sh/ruby or some weird configuration file format (like X resource files), beside C, to customize it for your needs: you only have to learn C (at least in order to edit the header file).
     42 * Because dwm is customized through editing its source code, it's pointless to make binary packages of it. This keeps its userbase small and elitist. No novices asking stupid questions. There are some distributions that provide binary packages though.
     43 * dwm reads from the root window's name to print arbitrary status text (like the date, load, battery charge). That's much simpler than larsremote, wmiir and what not...
     44 * **NEW** dwm creates a view for each Xinerama screen.
     45 
     46 Links
     47 -----
     48 * Mailing List: `dev+subscribe@suckless.org` ([Archives](//lists.suckless.org/dev/)) ([Old Archives](//lists.suckless.org/dwm/)) (see [community](//suckless.org/community/) for details)
     49 * IRC channel: #suckless at irc.oftc.net
     50 
     51 Download
     52 --------
     53 * [MIT/X Consortium license](//git.suckless.org/dwm/plain/LICENSE)
     54 * [dwm 6.1](//dl.suckless.org/dwm/dwm-6.1.tar.gz) (25kb) (20151109)
     55 * See also [dmenu](//tools.suckless.org/dmenu)
     56 
     57 Support
     58 -------
     59 See the [faq](//dwm.suckless.org/faq) for the frequent problems that
     60 arise. The next step is to look at the sourcecode and the config.h for obvious
     61 names, which could be related to the problem that arose. If that does not help
     62 to fix the problem, then there is the #suckless IRC channel and the
     63 mailinglist.
     64 
     65 If it is your first time using dwm, start with reading the
     66 [tutorial](//dwm.suckless.org/tutorial).
     67 
     68 Development
     69 -----------
     70 You can [browse](//git.suckless.org/dwm) its source code repository or get a copy using git  with the following command:
     71 
     72 	git clone https://git.suckless.org/dwm
     73 
     74 Miscellaneous
     75 -------------
     76 * Optionally you can install [dmenu](//tools.suckless.org/dmenu) to extend dwm with a wmii-like menu.
     77 * Wikipedia [article about dwm](http://en.wikipedia.org/wiki/Dwm)
     78 
     79 Related discussion
     80 ------------------
     81 * <https://www.ghcif.de/tag/dynamic-window-manager/> (German)
     82 * [dwm blog post in Persian](http://efazati.blog.ir/post/DWM-%D8%B1%D8%A7%D9%87%DA%A9%D8%A7%D8%B1-%D9%85%D9%86%D8%A7%D8%B3%D8%A8%DB%8C-%D8%A8%D8%B1%D8%A7%DB%8C-%D9%85%D8%AF%DB%8C%D8%B1%DB%8C%D8%AA-%D9%BE%D9%86%D8%AC%D8%B1%D9%87-%D9%87%D8%A7-%D8%AF%D8%B1-%D9%84%DB%8C%D9%86%D9%88%DA%A9%D8%B3)
     83 * <http://www.gambaru.de/blog/2011/12/10/elitare-fenstermanager-sind-vielleicht-doch-einfacher-zu-bedienen-als-gedacht/>
     84 * <http://www.linuxjournal.com/content/going-fast-dwm>
     85 * <http://www.linuxgoodies.com/review_dwm.html>
     86 * <http://www.iyiz.com/20-most-simple-and-cool-x-window-managers-for-linux/>
     87 * <http://lbolla.wordpress.com/2010/01/08/dwm-restart/>
     88 * <http://danielkaes.wordpress.com/2009/12/03/adding-a-pidgin-trayicon-to-dwm/>
     89 * <http://openmindlifestyle.wordpress.com/2009/11/28/howto-compile-and-configure-dwm-tiling-window-manager-on-ubuntu/>
     90 * <http://lsetc.wordpress.com/2009/11/27/gno-more-gnome/>
     91 * <http://www.youtube.com/watch?v=F2sYPwuRPvc>
     92 * <http://houst0n.wordpress.com/2009/12/20/dwm-the-dynamic-window-manager-for-solaris/>
     93 * <http://the-monkeymind.blogspot.com/2007/03/dwm-dynamic-window-manager-home-page-at.html>
     94 * <http://tonytraductor.livejournal.com/120674.html>
     95 * <http://forums.debian.net/viewtopic.php?f=16&t=65110>
     96 * <http://wongdev.com/blog/dwm-tags-are-not-workspaces/>
     97 * [dwm usage and configuration page (french)](http://yeuxdelibad.net/Logiciel-libre/Suckless/dwm/index.html)
     98 * <http://www.youtube.com/watch?v=GQ5s6T25jCc>
     99 * <https://srobb.net/dwm.html>
    100 * <http://rhunter.org/blog/2012/04/17/dwm-a-tutorial-for-beginners/>
    101 * <https://cannibalcandy.wordpress.com/2012/04/26/installing-and-configuring-dwm-under-ubuntu/>
    102 * <http://blog.yjl.im/2011/07/two-weeks-with-dwm.html>
    103 * <http://www.murga-linux.com/puppy/viewtopic.php?p=258224>
    104 * <http://opensourceforu.com/2012/03/tiling-window-managers-getting-started-with-dwm/>
    105 
    106 related projects
    107 ----------------
    108 * [awesome](http://awesome.naquadah.org/) -- dwm fork with XCB, EWMH, Lua script, Xft, D-Bus, multihead.. support
    109 * [awm](https://github.com/Alpt/awm/blob/master/README) -- (old) modified dwm with workspaces and /proc like interface
    110 * [bwm](//lists.suckless.org/dwm/0708/3085.html) -- (old) modified dwm with extensive mouse support
    111 * [cons-wm](http://github.com/dharmatech/psilab/tree/master/cons-wm) -- minimalist wm in scheme (not tiled)
    112 * [bug.n](https://github.com/fuhsjr00/bug.n) -- dwm for Windows written in AutoHotkey
    113 * [dvtm](http://www.brain-dump.org/projects/dvtm/) -- virtual terminal manager (dwm on the console)
    114 * [dwm-gtx](http://s01.de/~gottox/index.cgi/proj_dwm) -- dwm branch with Xinerama support, pointer movement, different layout
    115 * [dwm-sprinkles](http://0mark.unserver.de/dwm-sprinkles/) -- dwm with colorfull bar, transparency, pre-configured pertag and more
    116 * [dwm-win32](http://www.brain-dump.org/projects/dwm-win32/) -- dwm ported to windows
    117 * [echinus](http://www.rootshell.be/~polachok/code/) -- dwm fork with EWMH, Xft support
    118 * [gemini](http://gemini.digitalmediaplanet.net) -- terminal manager
    119 * [i3](http://i3.zekjur.net/) -- wmii fork with XCB, multihead, vertical column, command mode
    120 * [qtile](http://www.qtile.org/) -- pure python wm, used ideas from dwm
    121 * [scrotwm](http://www.peereboom.us/scrotwm/html/scrotwm.html) -- dwm clone with multihead, config file, restart.. support
    122 * [TAL/wm](http://talwm.sourceforge.net/) -- minimal tiled wm based on dwm (discontinued)
    123 * [teslawm](http://teslawm.org/) -- dwm fork with multihead, mouse, stdin commands support (was dwm-rfigura)
    124 * [xmonad](http://www.xmonad.org/) -- dwm clone in haskell