Go to file
Julien Danjou 06b490d319 statusbar: widget_get() returns a dict
Signed-off-by: Julien Danjou <julien@danjou.info>
2008-07-01 16:53:20 +02:00
build-utils atoms: autogenerate atom list 2008-06-30 20:05:53 +02:00
common statusbar: merge colors_set() into index 2008-07-01 16:50:03 +02:00
icons Added magnifier icons. 2008-06-14 00:03:04 +02:00
layouts client: honor size hints is now by client 2008-06-25 15:42:07 +02:00
lib tag: layout use index 2008-07-01 15:06:20 +02:00
widgets widgets: don't tokenize twice 2008-07-01 15:27:41 +02:00
.gitignore build: add a Makefile to run cmake automagically 2008-07-01 08:25:40 +02:00
AUTHORS update AUTHORS file 2008-06-26 22:01:09 +02:00
BUGS BUG's page 2008-04-18 19:33:58 +02:00
CMakeLists.txt atoms: autogenerate atom list 2008-06-30 20:05:53 +02:00
LICENSE chance license to GPLv2 2007-09-12 14:29:51 +02:00
Makefile build: fix mode 2008-07-01 09:17:22 +02:00
README build: add a Makefile to run cmake automagically 2008-07-01 08:25:40 +02:00
STYLE Fix STYLE file to reflect current style [CORRECTIVE] 2008-03-24 07:49:33 +01:00
awesome-client.1.txt Revert "Replace tags by workspaces" 2008-06-09 21:56:03 +02:00
awesome-client.c comments fixing 2008-06-20 08:38:00 +02:00
awesome-version-internal.h.in cmake: consolidate version strings 2008-06-22 22:13:06 +02:00
awesome.1.txt [manpage] Update 2008-06-11 09:56:19 +02:00
awesome.c atom: new atom infra 2008-06-30 18:25:01 +02:00
awesome.doxygen.in cmake: configure awesome.doxygen 2008-06-19 22:28:47 +02:00
awesomeConfig.cmake Add stricter warnings wrt prototypes. 2008-07-01 08:12:22 +02:00
awesomerc.5.txt widget: new widget index method 2008-06-26 16:35:07 +02:00
awesomerc.lua.in tag: remove mwfact_{get,set}, use {new,}index 2008-07-01 13:59:40 +02:00
client.c draw: iso2utf now gets len as arg 2008-07-01 14:44:19 +02:00
client.h If awesome believes we have the focus, well, do not unfocus ourselves. 2008-06-27 09:34:47 +02:00
cnode.c comments fixing 2008-06-20 08:38:00 +02:00
cnode.h [focus] Split client_node functions out 2008-05-25 18:12:27 +02:00
config.h.in cmake: consolidate version strings 2008-06-22 22:13:06 +02:00
dbus.c remove useless #include 2008-06-26 18:10:45 +02:00
dbus.h Plug dbus in the event loop. 2008-06-16 23:51:07 +02:00
event.c Hide keybindings away 1/2 2008-07-01 08:12:22 +02:00
event.h Make event handler setup private to the event module. 2008-06-26 22:47:56 +02:00
ewmh.c atoms: add all used atoms 2008-06-30 18:55:14 +02:00
ewmh.h atom: new atom infra 2008-06-30 18:25:01 +02:00
focus.c Revert "Replace tags by workspaces" 2008-06-09 21:56:03 +02:00
focus.h Revert "Replace tags by workspaces" 2008-06-09 21:56:03 +02:00
keybinding.c Hide keybidings_t away, subsequent simplifications 2/2 2008-07-01 08:12:22 +02:00
keybinding.h Hide keybidings_t away, subsequent simplifications 2/2 2008-07-01 08:12:22 +02:00
keygrabber.c Simplify keygrabber. 2008-06-30 00:47:11 +02:00
keygrabber.h [keygrabber] Fix key mapping 2008-06-10 22:37:45 +02:00
layout.c remove useless #include 2008-06-26 18:10:45 +02:00
layout.h Revert "Replace tags by workspaces" 2008-06-09 21:56:03 +02:00
lua.c draw: iso2utf now gets len as arg 2008-07-01 14:44:19 +02:00
lua.h lua: remove luaA_name_init 2008-06-30 13:50:49 +02:00
mouse.c mouse: fix args for mouse.coords_set() 2008-07-01 09:27:34 +02:00
mouse.h [client] Rework raise and mouse stuff 2008-05-26 18:08:29 +02:00
placement.c remove useless #include 2008-06-26 18:10:45 +02:00
placement.h placement: rename FloatingPlacement to floating_placement_t 2008-06-15 10:55:07 +02:00
screen.c screen: merge tag_client_with_current_selected() code 2008-06-27 23:00:20 +02:00
screen.h Revert "Replace tags by workspaces" 2008-06-09 21:56:03 +02:00
stack.c ewmh: add support for _NET_CLIENT_LIST_STACKING 2008-06-17 21:47:57 +02:00
stack.h [client] Add proper stacking support 2008-05-25 19:32:30 +02:00
statusbar.c statusbar: widget_get() returns a dict 2008-07-01 16:53:20 +02:00
statusbar.h lua: userdata_new is now macro 2008-06-18 18:31:35 +02:00
structs.h widgets: don't tokenize twice 2008-07-01 15:27:41 +02:00
systray.c atoms: add all used atoms 2008-06-30 18:55:14 +02:00
systray.h systray: add KDE work around 2008-06-30 13:06:23 +02:00
tag.c tag: layout use index 2008-07-01 15:06:20 +02:00
tag.h draw: iso2utf now gets len as arg 2008-07-01 14:44:19 +02:00
titlebar.c titlebar: ref widget on get() 2008-07-01 16:53:00 +02:00
titlebar.h lua: userdata_new is now macro 2008-06-18 18:31:35 +02:00
widget.c widget: move name into index 2008-07-01 16:18:32 +02:00
widget.h widget: new widget index method 2008-06-26 16:35:07 +02:00
window.c Hide keybindings away 1/2 2008-07-01 08:12:22 +02:00
window.h Hide keybindings away 1/2 2008-07-01 08:12:22 +02:00

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:
  - cmake
  - Xlib, xcb and xcb-util
  - Lua 5.1
  - cairo
  - pango and pangocairo
  - libev
  - glib
  - GdkPixBuf or Imlib2 (use -DWITH_IMLIB2=1 with cmake)
  - dbus (optional, use -DWITH_DBUS=0 with cmake to disable)
  - gperf

In order to build the awesome man pages and documentation,
you need these tools:
  - asciidoc
  - xmlto
  - docbook XSL stylesheets
  - luadoc

In order to build the source code reference, you need these tools:
  - doxygen
  - graphviz

Building and Installation
-------------------------
After extracting the dist tarball, run:

  make

This will create a build directory, run cmake in it and build awesome.

After the building done, you can type this to install:

  make install # might need root permissions

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.lua file.
An example is provided in the sources.