What is Engage?
Engage is a dockbar based on Enlightenment Foundation Libraries. There are two version of Engage. There’s a standalone version and a module version for E17. The module Engage currently works as an app-launcher, taskbar and a system tray. Click here for more detail.
I install Engage on My Ubuntu Dapper Drake as a standalone version. So it’s work in my Ubuntu default windowmanager (GNOME).
Engage on Ubuntu Repository
An easly way to install Engage:
Add this following line to my /etc/apt/sources.list
deb http://soulmachine.net/breezy/ unstable/
Download public key from that repository
wget soulmachine.net/public.key && sudo apt-key add public.key
Update my repository
sudo apt-get install engage
Configure my Engage to suitable for my desktop.
Install From CVS
Just try to install from CVS 😀 I don’t have experience with bash programming. So I make it by my self and It’s just make easier for me to install Engage 😀
Install some packages required for Engage to compile properly
sudo apt-get install cvs autoconf automake1.7 gettext libtool libfreetype6-dev libjpeg62-dev libpng3-dev libtiff4-dev libungif4-dev libbz2-dev libltdl3-dev pkg-config libxine-dev libgtk1.2-dev build-essential flex bison byacc libxcursor-dev libcurl3-dev
Getting the sources
cd ~/ mkdir cvs
cvs -d:pserver:anonymous:@cvs.sourceforge.net:/cvsroot/enlightenment login
cvs -z3 -d:pserver:anonymous:@cvs.sourceforge.net:/cvsroot/enlightenment co e17 misc
EFL?s compilation (Enlightenment Foundation Libraries)
Before starting to compile, I need to add a line in the /etc/ld.so.conf file, to allow the programs to access the newly installed library (/usr/local/lib) when running ldconfig command.
sudo -s -H
echo "/usr/local/lib" >> /etc/ld.so.confexit
The common procedure to compile every library is:
sudo make install
There are 15 libraries need to be complied (edb, eet, imlib2, imlib2_loaders, evas, ecore, epeg, embryo, edje, epsilon, esmart, emotion, etox, ewl, engrave) and locate at ~/cvs/e17/libs/.
I just compile and install 3 applications for my Engage:
- /cvs/e17/apps/e_utils : configuration tools for E17
- /cvs/e17/apps/examine : configuration tools for the applications
- /cvs/misc/engage : The beautiful MAC OS X style dockGo to each directory compile and install them with standard procedure (mention above)
If you feel sick to do this one by one, You can download my simple
install script that will help to compile and to install all libraries and applications. If you feel Engage not suitable for you, just run this uninstall script. Download these files to ~/cvs. And change ext from .txt to .sh
After all libraries and engage have been installed succesfully. We need to configure it.
Make directory to our new engage
This directory will use to store our EAP files.
mkdir -p ~/.e/e/applications/all
Make “.order” file
This file is simply a list of EAP files in the order we want them to show up in the bar.
You can download my EAP files and my “.order” file for example. You can make them by yourself (^ ^,)
To show analog clock and digital clock, copy either expedition.edj or digital.edj from http://cvs.sourceforge.net/viewcvs.py/enlightenment/misc/engage/ to ~/.e/apps/engage/sysicons. Perhaps You need to create sysicons directory.
EAP Icon Files
Creating EAP files using the graphical tool
E17 includes an integrated EAP editor, use this command:
Add all the information you need, but ignore the “Window name” section. That needs to be left empty. Then select an icon file. It can be of any size. The bigger the file, the more memory it uses though. Note that you don’t have to have the full path for the executable – just the name of the program is ok too, assuming the program is in your shell path. After the icon is made the original icon picture isn’t needed anymore for the icon to work: it is included in the created EAP file. All EAP files you create with this editor are automatically moved to ~/.e/e/applications/all.
Creating and modifying EAP files the manual way
Extract icon_example.tar.gz from /usr/share/enlightenment/data/other (depending on where you installed E17) and go to the directory that is created. You will see three files: build.sh, icon.edc and icon.png.
Edit icon.edc and change the “max:” value to something you want. If your icons are 128×128 PNG files, “128 128” would for example be a good choice. Next, copy an icon .png file over the default icon.png. Note that your icon needs to be named icon.png. If you wish to use a different name, you can edit icon.edc and build.sh and change the application lines that mention icon.png.
# a .eap file is just a .edj file with added meta data for
# application launch info. enlightenment_eapp
# can add/modify/delete this metadata.
# The script below is an example of building an eap icon from scratch.
# actually compile a edje file with all the gfx etc.
edje_cc [email protected] -id . -fd . icon.edc icon.eap
# add eapp properties to the file
#- they are ALL optional EXCEPT name and exe
# and exe is optional for directory .eapp files
-set-name "Application Name"
-set-generic "Generic name"
-set-comment "Comment on what this application does"
# other options u might want to use:
# -lang LANG
# -set-startup-notify 1/0
# -set-win-title "window_title*glob"
# -set-win-role "window_role"
# -set-wait-exit 1/0
# see enlightenment_eapp -h for more -set options
You’ll need to fill this form, except do not set the window name. That needs to be empty (as in -set-win-name “” )! Also make sure that you get the window class correct, since otherwise the icon won’t be displayed in the top-left corner of the window border once you launch the application using your newly created EAP file. You can find out the window class by issuing the following command in a terminal:
xprop WM_CLASS|cut -d , -f 2
And then clicking a window. Alternatively you can easily find out the window class by using the integrated EAP editor, which you can open by clicking “Create Icon” in the menu that is displayed when you left-click the top-left corner of the window decoration menu. You can also access the same menu by right clicking anywhere on the top window decoration bar. This editor should show the correct window class of the application it was opened from by default.Now all you need to do is run build.sh and it should create a file called icon.eap in the same directory. Rename it to whatever you want and move it to ~/.e/e/applications/all. After you’ve created some EAP files there’s an easy manual way to edit the information (everything else except the image itself – for that you’ll need to use the graphical EAP editor).
OSX Icon Theme
These icons have been modified from OSX icon set created by kiddo.I have converted them to EAP format for usage in Enlightenment DR 17.
Thx to Kiddo 😉