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

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) Enlightenment desktop, you can install it using a script called e17-svn 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. A script called easy_e17 is at the heart of the e17-svn package we will install here. Additional software and tools can be installed via the oz-desktop package.

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"

It is a good idea to start this process with a fully updated version of your current OS. 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) or later (including the latest alpha/beta/RC versions):

sudo sh -c "echo 'deb http://cafelinux.org/Downloads/oz-os hungrytiger 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

4. Install e17-svn

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.

The e17-svn package pulls in and starts the easy_e17 script. This downloads and installs e17 from current source code. It is a long process, so feel free to do something else for an hour or so!

At the end of the download and install, the easy_e17 script will run.  It will download, compile and install e17.   The install process will place a number of new files on your hard drive in predetermined file locations.   This is also a long process but at the end of it you will have an e17 session that can be logged into from your log-in manager. 

If that's all you want, feel free to log into the e17 and go through the First Run Wizard - a short series of screens that sets up your theme and default applications.  You will be presented with three set-up screens - select your language on the first (if there are options!), on the second screen select "standard" (NOT "illume") and on the third go with the default menus.  The long list of packages in the next screen lets you set up your "ibar" launcher - this can be done manually later if you prefer. You can then tweak e17 as much as you want!

5. Install the oz-desktop package.

You can have the complete OzOS package (with the additional recommended packages and tools) 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).

If you get an error at this point - referring specifically to a missing oz-desktop-base package, simply copy the following into your terminal and press enter:

sudo aptitude install oz-desktop-base

Once installed you will have the OzOS themed desktop and the oz tools on your menus.

6. Close the terminal and logout of your desktop.

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

7. Explore and enjoy!

 

 To get the "classic" OzOS look, use the "Rusted Emerald" theme - On the main menu (left-click on the desktop) select Settings>Theme and scroll the first column of the Theme Selector to RustedEmerald, highlight it and click "Apply".

Note: If you do switch to the Rusted Emerald theme, the first thing you have to do is open the Theme Selector dialog in its Advanced mode and assign both "icons" and "widgets" to the b_and_w theme (otherwise your "system" functions won't display or respond properly. 

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.