| 1 | evilwm 1.0 by Ciaran Anscomb <evilwm@6809.org.uk> |
|---|
| 2 | |
|---|
| 3 | evilwm is a minimalist window manager for the X Window System. |
|---|
| 4 | |
|---|
| 5 | The name evil came from Stuart 'Stuii' Ford, who thinks that any software |
|---|
| 6 | I use must be evil and masochistic. In reality, this window manager is |
|---|
| 7 | clean and easy to use. |
|---|
| 8 | |
|---|
| 9 | |
|---|
| 10 | FEATURES |
|---|
| 11 | |
|---|
| 12 | * No window decorations apart from a simple 1 pixel border. |
|---|
| 13 | * No icons. |
|---|
| 14 | * Good keyboard control, including repositioning and maximise toggles. |
|---|
| 15 | * Solid window drags (optional - may be slow on old machines). |
|---|
| 16 | * Virtual desktops. |
|---|
| 17 | * Small binary size (even with everything turned on). |
|---|
| 18 | |
|---|
| 19 | |
|---|
| 20 | INSTALLATION |
|---|
| 21 | |
|---|
| 22 | Please see the file INSTALL for details on building evilwm. |
|---|
| 23 | |
|---|
| 24 | |
|---|
| 25 | STARTING EVILWM |
|---|
| 26 | |
|---|
| 27 | If you use a session manager from GNOME or KDE or something like that, |
|---|
| 28 | you'll have to read its documentation to see how to set which window |
|---|
| 29 | manager it uses. |
|---|
| 30 | |
|---|
| 31 | However if you're just using a standard X desktop, you can start evilwm |
|---|
| 32 | by just changing your ~/.xinitrc file. Here's a pretty standard sample |
|---|
| 33 | file: |
|---|
| 34 | |
|---|
| 35 | -----CUT HERE----- |
|---|
| 36 | [ -f $HOME/.Xdefaults ] && xrdb $HOME/.Xdefaults |
|---|
| 37 | xsetroot -solid \#400040 -cursor_name top_left_arrow |
|---|
| 38 | /usr/bin/evilwm -snap 10 & |
|---|
| 39 | exec xclock -digital -padding 2 -g -0+0 |
|---|
| 40 | -----CUT HERE----- |
|---|
| 41 | |
|---|
| 42 | Note that in this case 'xclock' is the magic process (the one that if |
|---|
| 43 | you kill it, your session dies). You could change it around and have |
|---|
| 44 | evilwm be your magic process if you prefer. Also note that it sets the |
|---|
| 45 | cursor shape and background colour with standard X tools (evilwm won't |
|---|
| 46 | do this for you - the tools already exist!). |
|---|
| 47 | |
|---|
| 48 | |
|---|
| 49 | CONTROLS |
|---|
| 50 | |
|---|
| 51 | You can use the mouse to manipulate windows either by click/dragging |
|---|
| 52 | the 1 pixel border, or by holding down Alt and doing so anywhere in the |
|---|
| 53 | client window. The controls are: |
|---|
| 54 | |
|---|
| 55 | Button 1 Move window. |
|---|
| 56 | Button 2 Resize window. |
|---|
| 57 | Button 3 Lower window. |
|---|
| 58 | |
|---|
| 59 | Most keyboard controls are used by holding down Control and Alt, then |
|---|
| 60 | pressing a key. Available functions are: |
|---|
| 61 | |
|---|
| 62 | Return Spawn new xterm. |
|---|
| 63 | Escape Delete current window. |
|---|
| 64 | Insert Lower current window. |
|---|
| 65 | H, J, K, L Move window left, down, up or right (16 pixels). |
|---|
| 66 | Holding Shift resizes the window instead. |
|---|
| 67 | Y, U, B, N Move window to top-left, top-right, bottom-left or |
|---|
| 68 | bottom-right of screen. |
|---|
| 69 | I Show information about current window. |
|---|
| 70 | Equals Maximise current window vertically (toggle). |
|---|
| 71 | X Maximise current window (toggle). |
|---|
| 72 | |
|---|
| 73 | If compiled with virtual desktop support, these functions are also |
|---|
| 74 | available: |
|---|
| 75 | |
|---|
| 76 | F Fix or unfix window (toggle its 'sticky' status). |
|---|
| 77 | 1 - 8 Switch virtual desktop. |
|---|
| 78 | Left Previous virtual desktop. |
|---|
| 79 | Right Next virtual desktop. |
|---|
| 80 | |
|---|
| 81 | In addition to the above, Alt+Tab can be used to cycle through windows |
|---|
| 82 | on screen. |
|---|
| 83 | |
|---|
| 84 | |
|---|
| 85 | ACKNOWLEDGEMENTS |
|---|
| 86 | |
|---|
| 87 | The original code base for this project was that of aewm by Decklin |
|---|
| 88 | Foster. His code is very clean and, in later versions, very well |
|---|
| 89 | commented. I'd recommend it if you want to learn more about window |
|---|
| 90 | manager theory (or indeed want title bars, etc ;). |
|---|
| 91 | |
|---|
| 92 | http://www.red-bean.com/~decklin/aewm/ |
|---|
| 93 | - aewm homepage |
|---|
| 94 | |
|---|
| 95 | |
|---|
| 96 | LICENCE |
|---|
| 97 | |
|---|
| 98 | evilwm 1.0 |
|---|
| 99 | Copyright (C) 1999-2006 Ciaran Anscomb <evilwm@6809.org.uk> |
|---|
| 100 | |
|---|
| 101 | This is free software. You can do what you want to it, but if it |
|---|
| 102 | breaks something, you get to pay for the counselling. The code was |
|---|
| 103 | originally based on aewm, so this is distributed under the same terms, |
|---|
| 104 | which follow. |
|---|
| 105 | |
|---|
| 106 | |
|---|
| 107 | AEWM LICENCE |
|---|
| 108 | |
|---|
| 109 | Copyright (c) 1998-2000 Decklin Foster. |
|---|
| 110 | |
|---|
| 111 | THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS", WITHOUT ANY EXPRESS |
|---|
| 112 | OR IMPLIED WARRANTIES OF ANY KIND. IN NO EVENT SHALL THE AUTHOR BE |
|---|
| 113 | HELD LIABLE FOR ANY DAMAGES CONNECTED WITH THE USE OF THIS PROGRAM. |
|---|
| 114 | |
|---|
| 115 | You are granted permission to copy, publish, distribute, and/or sell |
|---|
| 116 | copies of this program and any modified versions or derived works, |
|---|
| 117 | provided that this copyright and notice are not removed or altered. |
|---|
| 118 | |
|---|
| 119 | Portions of the code were based on 9wm, which contains this license: |
|---|
| 120 | |
|---|
| 121 | > 9wm is free software, and is Copyright (c) 1994 by David Hogan. |
|---|
| 122 | > Permission is granted to all sentient beings to use this software, |
|---|
| 123 | > to make copies of it, and to distribute those copies, provided |
|---|
| 124 | > that: |
|---|
| 125 | > |
|---|
| 126 | > (1) the copyright and licence notices are left intact |
|---|
| 127 | > (2) the recipients are aware that it is free software |
|---|
| 128 | > (3) any unapproved changes in functionality are either |
|---|
| 129 | > (i) only distributed as patches |
|---|
| 130 | > or (ii) distributed as a new program which is not called 9wm |
|---|
| 131 | > and whose documentation gives credit where it is due |
|---|
| 132 | > (4) the author is not held responsible for any defects |
|---|
| 133 | > or shortcomings in the software, or damages caused by it. |
|---|
| 134 | > |
|---|
| 135 | > There is no warranty for this software. Have a nice day. |
|---|
| 136 | |
|---|
| 137 | evo sad cu ja tu nesto dodat! |
|---|
