Awesome-3-git-Gentoo

This page is intended to show Gentoo users how to use awesome 3 from git.

You need to have root access all of this

I have this script to automatically fetch the latest version of awesome and wicked; it creates symlinks for the man pages and the wicked library. It also fetches the latest version of xcb-util in case you want the latest version.

if [ "$(id -u)" != "0" ]; then echo "This script must be run as root" 1>&2 exit 1 fi rm -rvf /usr/local/src/awesome-git git clone git://git.naquadah.org/awesome.git /usr/local/src/awesome-git rm -rvf /usr/local/src/xcb-util-git git clone git://anongit.freedesktop.org/git/xcb/util /usr/local/src/xcb-util-git rm -rvf wicked-git rm -rv /usr/local/share/awesome/lib/wicked.lua rm -rv /usr/share/man/man7/wicked.7.gz git clone git://git.glacicle.com/awesome/wicked.git /usr/local/src/wicked-git ln -sv /usr/local/src/wicked-git/wicked.lua /usr/local/share/awesome/lib/wicked.lua ln -sv /usr/local/src/wicked-git/wicked.7.gz /usr/share/man/man7/wicked.7.gz
 * Put the script in /usr/local/src, it doesn't matter what you name it (I named it update.sh)
 * 1) ! /bin/sh

chmod +x update.sh
 * Make that executable with

Now you need to edit your /etc/portage/package.keywords (if it isn't there, create it) to allow you to get the versions of cmake (version 2.6>), xcb (version 1.1>), xcb-util (version 0.3.0>), xproto (version 7.0.12>), and xcb-proto (version 1.1>).

>=dev-util/cmake-2.6.2 ~x86 >=x11-libs/libxcb-1.1 ~x86 >=x11-libs/xcb-util-0.3.0 ~x86 >=x11-proto/xproto-7.0.12 ~x86 >=x11-proto/xcb-proto-1.1 ~x86
 * Your /etc/portage/package.keywords should look like this; along with anything else you already had in there.

Replace ~x86 with your arch (~amd64, et cetera).

Now all you have to do is emerge the dependencies for awesome, compile awesome, and enjoy!

To emerge the dependencies, just type this command in at your terminal (as root)

emerge -uav app-doc/doxygen dev-util/cmake dev-util/luadoc dev-lang/lua x11-libs/cairo x11-libs/libxcb x11-libs/pango x11-libs/xcb-util x11-proto/xproto

That should be all of the dependencies, if you get an error during the awesome compile, figure it out (you are using Gentoo, you should be competent enough to do that ;)).

Now to compile awesome, you need git to fetch the latest source for awesome. Just use the update script and it will do all of the fetching for you.

Once you have the source, go into the awesome-git folder, and compile and install awesome.

cd /usr/local/src/awesome-git make make install
 * Here's how you compile awesome

Now just add exec awesome to your .xinitrc and start X!