JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
Add more todo and bugs
[spectrwm.git] / html / scrotwm.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2 "http://www.w3.org/TR/html4/loose.dtd">
3 <html>
4 <head>
5 <title>Scrotwm</title>
6 <meta name="Generator" content="Vim/7.1">
7 <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
8 </head>
9 Welcome to Scrotwm's website.<p>
10 <small>
11 Scrotwm is a small dynamic tiling window manager for X11.
12 It tries to stay out of the way so that valuable screen real estate can
13 be used for much more important stuff.
14 It has sane defaults and does not require one to learn a language to do
15 any configuration.
16 It was written by hackers for hackers and it strives to be small, compact and
17 fast.
18 <p>
19 It was largely inspired by 
20 <a href="http://xmonad.org/">xmonad</a>
21 and
22 <a href="http://www.suckless.org/dwm/">dwm</a>.
23 Both are fine products but suffer from things like:
24 crazy-unportable-language-syndrome, silly defaults, asymmetrical window
25 layout, "how hard can it be?" and good old NIH.
26 Nevertheless  dwm was a phenomenal resource and many good ideas and code
27 was borrowed from it.
28 On the other hand xmonad has great defaults, key bindings and xinerama
29 support but is crippled by not being written in C.
30 <p>
31 Scrotwm is a beautiful pearl!
32 For it too, was created by grinding irritation.
33 Nothing is a bigger waste of time than moving windows around until they are the
34 right size-ish or having just about any relevant key combination being eaten
35 for some task one never needs.
36 The path of agony is too long to quote and in classical
37 <a href="http://www.openbsd.org">OpenBSD</a>
38 fashion (put up, or hack up) a brand new window manager was whooped up to serve
39 no other purpose than to obey its masters.
40 It was written by Marco Peereboom, Ryan Thomas McBride &amp; Darrin Chandler and it
41 is released under the ISC
42 <a href="license.html">license</a>.
43 Patches can be accepted provided they are ISC licensed as well.<br>
44 <p>
45 Following are a few screenshots of scrotwm in action.
46 <center>
47 <a href="scrotwm.jpg"><img border=0 src="scrotwm_small.jpg" alt="[scrotwm]"></a><br>
48 Vertical stack.
49 <p>
50 <a href="scrotwm2.jpg"><img border=0 src="scrotwm2_small.jpg" alt="[scrotwm2]"></a><br>
51 Horizontal stack.
52 <p>
53 <a href="scrotwm3.jpg"><img border=0 src="scrotwm3_small.jpg" alt="[scrotwm3]"></a><br>
54 Horizontal stack with gvim &amp;Firefox.
55 <p>
56 <a href="scrotwm4.jpg"><img border=0 src="scrotwm4_small.jpg" alt="[scrotwm4]"></a><br>
57 Vertical stack with floater and extra window in master area.
58 <p>
59 <a href="scrotwm5.jpg"><img border=0 src="scrotwm5_small.jpg" alt="[scrotwm5]"></a><br>
60 Mplayer, resized and moved.
61 </center>
62 <p>
63 </small>
64 <body bgcolor="#101010" text="#ffffff"> <font face="monospace">
65 Major features:<br>
66 - dynamic xrandr &amp; xinerama support (multi screen)<br>
67 - Navigation anywhere on all screens with either the keyboard or mouse<br>
68 - Customizable status bar<br>
69 - Human readable configuration file<br>
70 - Screenshots<br>
71 - Restartable without losing state<br>
72 - Quick launch menu<br>
73 - Many screen layouts possible with a few simple key strokes<br>
74 - Windows can be added or removed from master area<br>
75 - Windows can be moved to any workspace or within a region<br>
76 - Resizable master area<br>
77 - Move/resize floating windows<br>
78 - drag-to-float<br>
79 - User definable regions<br>
80 - User definable modkey &amp; key bindings<br>
81 - User definable quirk bindings<br>
82 <br>
83 To-do:<br>
84 - add search for window function<br>
85 - add identify window function<br>
86 - make alt-shift-arrows do nothing in single screen mode<br>
87 - remove fixed-length restrictions on quirk strings from conf file<br>
88 - switch scrotwm from Xlib to <a href="http://xcb.freedesktop.org">XCB</a><br>
89 - make floaters remember their spot when redrawing screen<br>
90 - make restacking work<br>
91 <br>
92 Known bugs:<br>
93 - upon create sometimes new window does not gain focus<br>
94 - upon destroy in multiscreen a window on the other screen gains focus<br>
95 - switching between empty workspaces followed by alt-shift-arrows might lead to window with focus but not properly colored border<br>
96 - linux make files are busted<br>
97 </font></body>
98 <p>
99 <small>
100 Please read the
101 <a href="man.html">man pages</a>
102 for a more detailed explanation.
103 <p>
104 You can download the source via anoncvs at:<br>
105 CVSROOT=anoncvs@anoncvs.freedaemon.com:/scrotwm<br>
106 Alternatively you can download periodic snapshots 
107 <a href="http://www.peereboom.us/scrotwm/snapshot">here</a>.<br>
108 <p>
109 To subscribe to CVS changes send an email to
110 <a href="mailto:majordomo@freedaemon.com">majordomo@freedaemon.com</a>
111 and in the email body say: subscribe scrotwm-changes.
112 <p>
113 Copyright (c) 2009 Marco Peereboom &lt;marco@peereboom.us&gt;,
114 Ryan Thomas McBride &lt;mcbride@countersiege.com&gt; &amp;
115 Darrin Chandler &lt;dwchandler@stilyagin.com&gt;<br>
116 <p>
117 <small>
118 $scrotwm$
119 </html>