summaryrefslogtreecommitdiff
path: root/README
blob: 1e6d198bfc1894e1823a5c15ea743ef1cc2dc10c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
-*- text -*-

This is a small window manager for the X Window System written
entirely with XCB, the straight X protocol binding to the C language.
It doesn't use libX11 which most older window managers do.

It's a traditional 'floating' window manager. It doesn't really do
anything new to the user experience. It is pretty stupid, but can
probably be useful for some people.

== Start ==

Start like this:

  mcwm [-b] [-t terminal-program]

-b means draw no borders around windows.

-t urxvt will start the urxvt terminal emulator when Mod1 + Return is
pressed. urxvt needs to be in the $PATH.

Typically mcwm will start automatically when you start the X Window
System. If you start from the console, you need an .xinitrc file.
Here's a complete example:

----------------- 8< -----------------
#! /bin/sh

# Set nice background.
xsetroot -mod 16 16 -fg rgb:54/6/6 -bg grey20

# Set nice pointer cursor.
xsetroot -cursor_name plus -fg white -bg black

# Load resources.
xrdb -load ~/.Xresources

# Start window manager in the background. If it dies, X still lives.
mcwm &

# Start a terminal in the foreground. If this dies, X dies.
urxvt
----------------- 8< -----------------

If you are using a graphical login program such as XDM you can use the
same file as .xsession instead.

== Use ==

With the the default configuration, use mcwm like this:

  Mod1 + mouse buttons:

    1 move
    2 raise
    3 resize

  Mod2 + key:

    r		raise or lower (toggles)
    x 		maximize
    m 		maximize vertically
    h 		move left
    j 		move down
    k 		move up
    l 		move right
    H 		resize left
    J 		resize down
    K 		resize up
    L 		resize right
    Return	start terminal

If you don't like the default key bindings, border width, et cetera,
look in the config.h file, change and recompile.

== More information & Contact ==

Please see:

  http://hack.org/mc/hacks/mcwm/

To contact me, write to:

  Michael Cardell Widerkrantz <mc@hack.org>