Private fork of https://github.com/awesomeWM/awesome
3b295beaed | ||
---|---|---|
build-utils | ||
common | ||
icons | ||
layouts | ||
widgets | ||
.gitignore | ||
AUTHORS | ||
BUGS | ||
LICENSE | ||
Makefile.am | ||
README | ||
STYLE | ||
UPGRADE | ||
autogen.sh | ||
awesome-client.1.txt | ||
awesome-client.c | ||
awesome-menu.1.txt | ||
awesome-menu.c | ||
awesome-message.1.txt | ||
awesome-message.c | ||
awesome.1.txt | ||
awesome.c | ||
awesome.doxygen.in | ||
awesome.h | ||
awesomerc.5.txt | ||
awesomerc.in | ||
client.c | ||
client.h | ||
config.c | ||
config.h | ||
configure.ac | ||
event.c | ||
event.h | ||
ewmh.c | ||
ewmh.h | ||
focus.c | ||
focus.h | ||
layout.c | ||
layout.h | ||
mouse.c | ||
mouse.h | ||
placement.c | ||
placement.h | ||
rules.c | ||
rules.h | ||
screen.c | ||
screen.h | ||
statusbar.c | ||
statusbar.h | ||
structs.h | ||
tag.c | ||
tag.h | ||
titlebar.c | ||
titlebar.h | ||
uicb.c | ||
uicb.h | ||
widget.c | ||
widget.h | ||
window.c | ||
window.h | ||
xcb_event_handler.c | ||
xcb_event_handler.h |
README
awesome ======= awesome is an extremely fast, small, and dynamic window manager for X. Requirements ------------ In order to build awesome itself, you need header files and libs of: - Xlib, Xinerama, Xrandr - libconfuse >= 2.6 - cairo - pango and pangocairo - Imlib2 or - GTK+ (use --with-gtk with ./configure) In order to build the awesome man pages, you need these tools: - asciidoc (recent version) - xmlto (recent version) - docbook XSL stylesheets In order to build the source code reference, you need these tools: - doxygen - graphviz Building and Installation ------------------------- If building from git sources, run "./autogen.sh". When autoreconf has finished, you can follow the following instructions for building a dist tarball. After extracting the dist tarball, run "./configure --help" and figure out what you might want to adapt for your system. Then run ./configure with the proper parameters, and build and install: ./configure [...] make make install # might need root permissions If you're using gcc as your compiler and do not want awesome's default set of warning flags, add AWESOME_CFLAGS="" to your "make" lines. The source code reference can be built with "make doc". 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.