These instructions explain automated installation methods for Gentoo Linux. But, of course, also the tarballs can be used to install Lila (see here).

Since we are using Gentoo Linux which is all about choices, we are providing several possible ways of installing Lila theme. This HOWTO will guide you through the process of setting up Lila theme. Feel free to skip sections that are talking about the obvious.

Thanks to salmo for his Liladdiction HOWTO and Ard Righ for his Quick Lila Install HOWTO which have been merged into this HOWTO and can both be found somewhere in the depths of the Lila Theme Official Thread on the Gentoo Discussion Forums. The Gentoo Portage Manual has been used as reference for non-Lila specific information. The last changes in respect to liladdiction were made by Christian Lemke.

All commands are either preceded by a # or a $. The # indicates a root prompt. You will need to issue these commands as root. The $ indicates a user prompt. It's recommended to issue these commands as a normal user.

If you are a non-Gentoo user or don't want to use the automatisms we provide, please skip to non-automated choice. When you are reading this, you have chosen to use our little installation helps, congratulations on that :) What you will need, regardless of the choice you are going to make below, is a PORTDIR_OVERLAY. If you already have one, please skip to automated choices. If you don't know what a PORTDIR_OVERLAY is or how to use it, by all means, read on.

A PORTDIR_OVERLAY directory is a place where one can store custom ebuilds (such as Lila) and portage will treat them as if they were in the actual portage tree without having everything erased by issuing emerge sync.

Setting up a PORTDIR_OVERLAY is quite easy. First create a directory where you want to put your custom ebuilds, usually /usr/local/portage.

# mkdir /usr/local/portage

Now we need to let portage know about this directory. So edit your /etc/make.conf file by doing

# nano -w /etc/make.conf

and modify the overlay line like

PORTDIR_OVERLAY="/usr/local/portage"

Your PORTDIR_OVERLAY is now set up and ready to be used. Please continue with automated choices.

• Choice A - Using the overlay with layman (recommended)
• Choice B - Using the overlay snapshot
• Choice C - Using the liladdiction script
• Choice D - Using the ebuilds

This is the recommended way of installing Lila for Gentoo.

First we need to install the utility layman if this is not already done:

# emerge layman

If this is the very first overlay you add with layman, you need to append the following statement to your /etc/make.conf file:

# echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf

Before adding the lila overlay let us fetch the global overlay list:

# layman -f

Now add the lila overlay to the local list of overlays and fetch the ebuilds with:

# layman -a lila-theme

To refresh and sync the local overlays (and so the lila-theme too) in the future you must enter:

# layman -S

The ebuilds are now known to portage, but they are masked by the ~arch keyword. In case you are running ~arch (e.g.: ~x86) you can simply run

# emerge -s lila

to get a list of all available lila packages.

Most people though, will need to unmask the ebuilds first. This can be achieved by listing all the lila packages you would like to emerge in /etc/portage/package.keywords. Have a look at the output of the command above to see what's there.

Create /etc/portage if it doesn't already exist.

# mkdir /etc/portage

Now either use echo or an editor of your choice.

# echo "x11-themes/lila-$package ~arch" >> /etc/portage/package.keywords

Where $package is any lila package found in the overlay and ~arch the architecture you are running, for example ~x86 or ~amd64 or ~ppc.

After that Lila can now be installed using emerge as you would do normally. Please also consider the post installation instructions.

Using the PORTDIR_OVERLAY directly without script? All right.

First you have to fetch the latest overlay from our server. You might want to verify its integrity with GnuPG. For this you need to download the corresponding .asc file from the same place you got the overlay and place it in the same directory. Now we need to add the current maintainers' public key to your keyring

$ gpg --keyserver wwwkeys.pgp.net --recv-keys 0x4D6111CE

and run

$ gpg --verify lila-theme-$date.tar.bz2.asc

Whereas $date is the actual date of the overlay.

Assuming that your PORTDIR_OVERLAY is /usr/local/portage we do

# mv lila-theme-*.tar.bz2 /usr/local/portage/
# tar -xvjf /usr/local/portage/lila-theme-*.tar.bz2

You should remove the tarball afterwards, as you don't need it anymore

# rm /usr/local/portage/lila-theme-*.tar.bz2

The ebuilds are now in your PORTDIR_OVERLAY, but they are masked by the ~arch keyword. In case you are running ~arch (e.g.: ~x86) you can simply run

# emerge -s lila

Have a look at what's there and install anything you like.

Most people though, will need to unmask the ebuilds first. This can be achieved by listing all the Lila packages you would like to emerge in /etc/portage/package.keywords. Have a look at your PORTDIR_OVERLAY to see what's there.

# ls /usr/local/portage/x11-themes

Create /etc/portage if it doesn't exist already.

# mkdir /etc/portage

Now either use echo or an editor of your choice.

# echo "x11-themes/lila-$package ~arch" >> /etc/portage/package.keywords

Where $package is any Lila package found in your PORTDIR_OVERLAY/x11-themes and ~arch the architecture you are running, for example ~x86 or ~amd64 or ~ppc.

After that Lila can now be installed using emerge as you would do normally. Please also consider the post installation instructions.

This was the recommended way of installing Lila for Gentoo, before layman came along and included our overlay. Liladdiction is a python script designed specifically for our needs, and like layman gets the latest Lila overlay with all the ebuilds.

If you're interested in fetching and installing the latest overlay run the script with no options. This will download and verify the latest overlay, extract it into your PORTDIR_OVERLAY (configurable at the top of the script, defaults to /usr/local/portage) check for a ~/.lila_themes file and digest and install the themes listed there. If there is no ~/.lila_themes file, it will prompt you for the packages to digest/install (and it only prompts once). It will also save the last overlay installed, and only download a overlay if a newer one is available.

If you have an existing ~/.lila_themes file from using lila-install (deprecated bash script) and you want to force it to prompt you for newly added ebuilds (such as the color themes) use the -p or --prompt option. Actually it prompts you for every ebuild all over again, so if you want to add or remove anything from your list, this is the way to do it. Unless, of course, you feel like editing your ~/.lila_themes file by hand, which you are perfectly welcome to do.

If you want to only download a new overlay, digest or install the latest ebuild of each package chosen (from ~/.lila_themes or --prompt mode) use the -aACTION or --action=ACTION where ACTION is one of download, digest, install or the default all.

Run it with -h or --help for a less verbose description of the options. --version prints the version.

Liladdiction uses GnuPG to verify the overlay tarballs. So you will need GnuPG installed!

At first download the liladdiction script from our server. You may place it anywhere you like.

$ wget http://lila-theme.berlios.de/files/script/liladdiction.py

We need to change permissions in order to execute the script.

$ chmod a+x liladdiction.py

All the Lila packages are masked by the ~arch keyword. That means that the packages should generally work but need testing. In case you are running ~arch you can simply run liladdiction and choose all the themes you want :)

# ./liladdiction.py

Most people though, will need to unmask the ebuilds first. This can be achieved by listing all the Lila packages you would like to install in /etc/portage/package.keywords. Have a look at the list of ebuilds available.

Create /etc/portage if it doesn't exist already.

# mkdir /etc/portage

Now either use echo or an editor of your choice.

# echo "x11-themes/lila-$package ~arch" >> /etc/portage/package.keywords

Where $package is any Lila package and ~arch the architecture you are running, for example ~x86 or ~amd64 or ~ppc.

Now you are ready to run liladdiction and choose all the themes you want :)

# ./liladdiction.py

After installation has finished please continue with the post installation instructions.

You chose to use the ebuilds directly. This is encouraged only if you plan to use merely a couple of ebuilds, because it is quite a tedious work to place and digest a lot of ebuilds in your PORTDIR_OVERLAY. But please, go on.

Assumed your PORTDIR_OVERLAY is in /usr/local/portage we do

# cd /usr/local/portage

Now we need to create directories for the Lila ebuilds. First we need the x11-themes directory

# mkdir x11-themes

Have a look at the list of ebuilds available. When you have chosen the Lila packages you would like to install you have to create a directory for each ebuild in x11-themes.

It's quite simple, for lila-$package-$version.ebuild you need to create a lila-$package directory

# mkdir x11-themes/lila-$package

Then fetch and digest the ebuild

# wget -P x11-themes/lila-$package http://lila-theme.berlios.de/files/ebuilds/lila-$package-$version.ebuild
# ebuild x11-themes/lila-$package/lila-$package-$version.ebuild digest

You need to go throught these tree steps for every ebuild you would like to emerge afterwards.

Now go on and install everything you just digested.

# emerge -av lila-$package1 lila-$package2 ...

That's it! Congratulations, you just installed Lila the hard way :) You might also want to have a look at the section for post installation instructions.