Private fork of https://github.com/awesomeWM/awesome
b6edff229c
<key> -> a, 1, F10 (/usr/include/X11/keysymdef.h w/o XK_, 'xev') <mod> -> mod1, mod2,..., mod5 these two lines may need some check/work. |
||
|---|---|---|
| icons/layouts | ||
| layouts | ||
| widgets | ||
| .gitignore | ||
| AUTHORS | ||
| LICENSE | ||
| Makefile | ||
| README | ||
| STYLE | ||
| awesome-client-common.c | ||
| awesome-client.1.txt | ||
| awesome-client.c | ||
| awesome-client.h | ||
| awesome.1.txt | ||
| awesome.c | ||
| awesome.doxygen | ||
| awesome.h | ||
| awesomerc | ||
| awesomerc.1.txt | ||
| client.c | ||
| client.h | ||
| config.c | ||
| config.h | ||
| config.mk | ||
| draw.c | ||
| draw.h | ||
| event.c | ||
| event.h | ||
| ewmh.c | ||
| ewmh.h | ||
| focus.c | ||
| focus.h | ||
| layout.c | ||
| layout.h | ||
| mouse.c | ||
| mouse.h | ||
| rules.c | ||
| rules.h | ||
| screen.c | ||
| screen.h | ||
| statusbar.c | ||
| statusbar.h | ||
| tag.c | ||
| tag.h | ||
| uicb.c | ||
| uicb.h | ||
| util.c | ||
| util.h | ||
| widget.c | ||
| widget.h | ||
| window.c | ||
| window.h | ||
| xutil.c | ||
| xutil.h | ||
README
awesome
=======
awesome is an extremely fast, small, and dynamic window manager for X.
It's based on dwm.
Requirements
------------
In order to build awesome you need the Xlib header files, libconfuse and cairo.
Creating the man pages also requires recent versions of the asciidoc and xmlto
tools.
Installation
------------
Edit config.mk to match your local setup (awesome is installed into
the /usr/local namespace by default).
Afterwards enter the following command to build and install awesome (if
necessary as root):
make install
Running awesome
-----------
Add the following line to your .xinitrc to start awesome using startx
or to .xsession to start awesome using gdm/kdm/xdm...:
exec awesome
In order to connect awesome to a specific display, make sure that
the DISPLAY environment variable is set correctly, e.g.:
DISPLAY=foo.bar:1 exec awesome
(This will start awesome on display :1 of the host foo.bar.)
Configuration
-------------
The configuration of awesome is done by creating a ~/.awesomerc file.
An example is provided in the sources.