How To: Install the OzOS desktop on an existing OS
Aubrey's picture

UPDATED for new method - Enlightenment code has moved to svn

If you are already using a relatively recent version of a Debian or Ubuntu-based OS and want to add the OzOS version of the Enlightment desktop, you can install it using a script called Easy_e17 available from the cafelinux/OzOS repositories. Uninstall instructions are here. This will provide an "Enlightenment.desktop" entry under your session selector when you login to your computer.

WARNING - PLEASE DO NOT INSTALL THE OzOS PACKAGES ON A MACHINE THAT ALREADY HAS ANOTHER VERSION OF THE ENLIGHTENMENT DESKTOP MANAGER INSTALLED. BREAKAGE IS LIKLEY!

Here's the recommended way to install:

1. Add the OzOS repositories to your "sources.list"

Open a terminal window on your current desktop and type or copy the following command:

sudo sh -c "echo 'deb http://cafelinux.org/Downloads/oz-os tinwoodman main' >> /etc/apt/sources.list"

AND For distros based on Ubuntu "Hardy Heron" (8.04):

sudo sh -c "echo 'deb http://cafelinux.org/Downloads/oz-os hungrytiger main' >> /etc/apt/sources.list"

OR For distros based on Ubuntu "Gutsy Gibbon" (7.10):

sudo sh -c "echo 'deb http://cafelinux.org/Downloads/oz-os scarecrow main' >> /etc/apt/sources.list"

2. Get the authentication keys for the OzOS repositories

This is a security measure. Type or copy the following command into the terminal:

wget -q http://cafelinux.org/Downloads/oz-os/key.asc -O- | sudo apt-key add -

3. Update your list of available packages

with the following command:

sudo apt-get update

3.1 Install cvs

This is a temporary measure to provide for some "transitional issues" with one of the components of e17 in the svn - one that still, for some reason, requires the "old" cvs package to compile properly.  We'll delete this step in the How-To when they fix this - but for now, it is necessary.

sudo apt-get install cvs

4. Install e17 and the oz-desktop package.

sudo apt-get install e17-svn

If you get an error like "package not found" at this point, check your sources.list file (in the /etc directory). On some distros, the first command above to add the cafelinux "tinwoodman main" repositories to your sources list will add it to the end of an existing line (rather than on a line by itself as it should be). If this happens, just open your sources.list with a text editor (with sudo or as root) and insert a line break before the word "deb" of the cafelinux repository.

You can have the complete OzOS package (with the additional recommended packages) by using the command:

sudo aptitude install oz-desktop

Or you can just install the OzOS e17 packages (without the recommended additional packages) with:

sudo aptitude --without-recommends install oz-desktop

The download and installation may take some time. You can watch progress in the terminal window (or go get a cup of coffee or take a short holiday in the tropics). The install process will place a number of new files on your hard drive in predetermined file locations.

5. Close the terminal and logout of your desktop.

Before logging back in, select "Enlightenment" from the list of available sessions.

6. Explore and enjoy!

Don't forget to update e17 from time to time. Instructions are here.

To Uninstall the oz-desktop, use the following commands:

sudo aptitude remove oz-desktop sudo apt-get autoremove

Notes

Note 1. Recommended Packages The following packages are installed as "recommended" in the full oz-desktop meta package: avahi-daemon, cups-pdf, discover1, displayconfig-gtk, file-roller, foo2zjs, gnome-system-tools, landscape-client, laptop-detect, libglib2.0-data, libjpeg-progs, libnss-mdns, linux-headers-generic, gnome-app-install, gnome-mount, meld, gtk2-engines-murrine, min12xxw, mozilla-thunderbird, notification-daemon, pxljr, python-exo, restricted-manager, scim, scim-gtk2-immodule, splix, thunar-media-tags-plugin, totem, thunar-volman, vim-runtime, wvdial, xcompmgr, xcursor-themes, xdg-utils

Note 2. File Locations OzOS installs the main Enlightenment files into the /opt folder. Personal files and settings are in your home folder in a hidden folder called ".e" Other packages (those not specific to Enlightenment) such as Thunar, Scite and the GTK libraries will install into their designated "normal" folders - eg in /usr/share/.... The uninstall process using aptitde should remove all these files as well as the Enlightenment system files and your personal /.e/ folders.