HOWTO Build Awesome 3

**Shinuza** · October 28th, 2008

This how-to purpose is to help you build Awesome 3 on Ubuntu Intrepid Ibex.

Table of contents:

1. What is Awesome 3
2. Why building?
3. Building
4. Troubleshooting
5. Infos and References

1. What is Awesome 3

Awesome is a dynamic window manager for the X Window System. Its development began in September 2007 as a fork of dwm. It aims at being extremely small and fast and supports multiple layouts such as floating, tiling, and maximized. Like many other tiling window managers, it strives to make it possible for the user to productively manage windows without the use of the mouse.

[From Wikipedia]

Awesome 3 is very speedful, uses XCB and Lua for configuration, and provide pipes for which you can build widgets to enhance your experience.

2. Why building?

At the time of writing Awesome version in Intrepid is 2.3.2-1 while the last release version is 3.x.

3. Building

Get utilities for building

Code:

$ sudo apt-get install build-essential autoconf automake libtool gperf xmlto git git-core cmake

Get dependencies for awesome

Code:

$ sudo apt-get install libx11-dev libxinerama-dev libxrandr-dev libpango1.0-dev libimlib2-dev libgtk2.0-dev libxcb-shm0-dev libxcb-render0-dev libxcb-randr0-dev libxcb-shape0-dev libcairo2-dev libxcb-xinerama0-dev liblua5.1-filesystem0 liblua5.1-logging libdirectfb-dev libxt-dev libx11-xcb-dev libev3 libev-dev libxcb-aux0

Get lua

Code:

$ sudo apt-get install lua5.1 liblua5.1-0-dev

Get Xcb utils and compile (Version in Intrepid Ibex is too old)

Code:

$ git clone git://anongit.freedesktop.org/git/xcb/util
$ cd util && ./autogen.sh && make && sudo make install

Get Awesome and compile

Code:

$ wget http://awesome.naquadah.org/download/awesome-3.1.tar.gz && tar xzf awesome-3.1.tar.gz
$ cd awesome-3.1 && make && sudo make install

[Partially from Awesome Wiki]

Finally, create an entry in GDM

Create a new .desktop file in /usr/share/xsessions, for example awesome.desktop
And copy paste :

Code:

   [Desktop Entry]
   Encoding=UTF-8
   Name=Awesome!
   Comment=This session starts Awesome 3
   Exec=/usr/local/bin/awesome
   Type=Application

Log out, choose your Awesome session, enjoy.
See 5 for configuration and extras.

4. Troubleshooting

1. If cmake complains about cairo-xcb :

Get Cairo and compile

Code:

$ wget http://www.cairographics.org/releases/cairo-1.8.0.tar.gz && tar xzf cairo-1.8.0.tar.gz && cd cairo* && ./configure --enable-xcb && make && sudo make install

You are not supposed to update Cairo with .deb at this point unless they are built with XCB support

Please tell me if you have any problem so I can update this how to.

5. Infos and References

**cl0ckwork** · October 28th, 2008

everything seems to work until i get to compiling awesome

Code:

$ git clone git://git.naquadah.org/awesome.git && cd awesome.git && make && sudo make install
Initialized empty Git repository in /home/clockwork/awesome/.git/
remote: Counting objects: 17242, done.
remote: Compressing objects: 100% (5609/5609), done.
remote: Total 17242 (delta 13052), reused 15144 (delta 11613)
Receiving objects: 100% (17242/17242), 3.05 MiB | 89 KiB/s, done.
Resolving deltas: 100% (13052/13052), done.
bash: cd: awesome.git: No such file or directory

**Shinuza** · October 30th, 2008

Originally Posted by cl0ckwork

everything seems to work until i get to compiling awesome

Code:

$ git clone git://git.naquadah.org/awesome.git && cd awesome.git && make && sudo make install
Initialized empty Git repository in /home/clockwork/awesome/.git/
remote: Counting objects: 17242, done.
remote: Compressing objects: 100% (5609/5609), done.
remote: Total 17242 (delta 13052), reused 15144 (delta 11613)
Receiving objects: 100% (17242/17242), 3.05 MiB | 89 KiB/s, done.
Resolving deltas: 100% (13052/13052), done.
bash: cd: awesome.git: No such file or directory

That's odd, apprently git creates awesome/.git instead of awesome.git

From your home try

Code:

$ mv awesome/.git ~/awesome.git

and then

Code:

$ cd awesome.git && make && sudo make install

**Vinno** · October 31st, 2008

(04:49 PM)[vinno@vinno:~/awesome/.git]$ ls
branches config description HEAD hooks index info logs objects refs
(04:50 PM)[vinno@vinno:~/awesome/.git]$ make
make: *** No targets specified and no makefile found. Stop.
(04:50 PM)[vinno@vinno:~/awesome/.git]$

Lost now.

**Gorbon Treeman** · October 31st, 2008

can anyone provide a .deb for awesome3 ?

thanx...

**jo_hann** · November 1st, 2008

Shinuza, i experienced a problem with your provided dependency package list:

Code:

libgtk2.0-devlibxcb-shm0-dev

could not be found. But the following did the job for me:

Code:

libxcb-shm0-dev

Also i would suggest to also install the following:

Code:

doxygen, luadoc, asciidoc

. That should be needed for the useful man-pages...
Also

Code:

libdbus-1-dev

could be installed if needed....

EDIT:
Also you missed to include

Code:

libxcb-aux0-dev

So here is the corrected, full list to copy-and-paste:

Code:

apt-get install build-essential autoconf automake libtool gperf xmlto git git-core cmake libx11-dev libxinerama-dev libxrandr-dev libpango1.0-dev libimlib2-dev libxcb-aux0-dev libxcb-render0-dev libxcb-randr0-dev libxcb-shape0-dev libcairo2-dev libxcb-xinerama0-dev liblua5.1-filesystem0 liblua5.1-logging libdirectfb-dev libxt-dev libx11-xcb-dev libev3 libev-dev lua5.1 liblua5.1-0-dev doxygen luadoc asciidoc libdbus-1-dev

Greetings
jo_hann

**jpt2433** · November 2nd, 2008

Originally Posted by Shinuza

That's odd, apprently git creates awesome/.git instead of awesome.git

From your home try

Code:

$ mv awesome/.git ~/awesome.git

and then

Code:

$ cd awesome.git && make && sudo make install

you shouldn't actually do the mv, simply

Code:

 # cd awesome && make && sudo make install

**super.rad** · November 5th, 2008

Had same problem as cl0ckwork jo_hann but installed libxcb-shm0-dev and had to use the command jtp2433 posted and all worked perfectly.
Thanks for the howto, been wanting to check out awesome 3 for a while now

EDIT: Tried it and now removing it, don't get on with tiling window managers at all. If i want a window manager I think I'll stick to openbox

**damog** · November 6th, 2008

Originally Posted by cl0ckwork

everything seems to work until i get to compiling awesome

Code:

$ git clone git://git.naquadah.org/awesome.git && cd awesome.git && make && sudo make install

You just do:

Code:

git clone git://git.naquadah.org/awesome.git && cd awesome && make && sudo make install

git takes the last directory on the clone url and creates it without the .git part

**Shinuza** · November 23rd, 2008

Originally Posted by jo_hann

Shinuza, i experienced a problem with your provided dependency package list:

Code:

libgtk2.0-devlibxcb-shm0-dev

could not be found. But the following did the job for me:

Code:

libxcb-shm0-dev

Greetings
jo_hann

Typo, updated.

Originally Posted by jpt2433

you shouldn't actually do the mv, simply

Code:

 # cd awesome && make && sudo make install

Please see below

Originally Posted by damog

You just do:

Code:

git clone git://git.naquadah.org/awesome.git && cd awesome && make && sudo make install

git takes the last directory on the clone url and creates it without the .git part

Thanks for the reply, my version of git left .git at the end of the directory name, updated.

Thread: HOWTO Build Awesome 3

Thread Tools

Display

HOWTO Build Awesome 3

Re: HOWTO Build Awesome 3

Re: HOWTO Build Awesome 3

Re: HOWTO Build Awesome 3

Re: HOWTO Build Awesome 3

Re: HOWTO Build Awesome 3

Re: HOWTO Build Awesome 3

Re: HOWTO Build Awesome 3

Re: HOWTO Build Awesome 3

Re: HOWTO Build Awesome 3

Tags for this Thread

Bookmarks

Bookmarks

Posting Permissions