jester
Member
Joined: 19 Apr 2024
Posts: 218
|
 Posted: Sun Feb 06, 2024 9:44 am Post subject: How to install and configure Engage - OSX like dock |
 |
|
Engage is one of the apps being developed as part of the new Enlightenment DR17. Luckily for us, it will actually run on most wm/de's.
Here I have it working under Gnome 2.8.x.
It's still under development so the code is CVS for now. If you're a Gentoo user then fear not, there are ebuilds in portage. For users of other distros I'll list which libraries you'll need to grab as well as the order in which to compile the source.
For Gentoo
First you'll need to edit your /etc/portage/package.keywords
as su do the following
| Code: | | nano -w /etc/portage/package.keywords |
now add the following
| Code: | x11-libs/esmart
media-libs/imlib2 -*
media-libs/edje
x11-libs/ecore
x11-libs/evas
x11-libs/ewl
x11-misc/engage
dev-libs/eet
dev-db/edb
dev-libs/embryo
media-libs/epsilon
media-libs/epeg
media-libs/etox
app-misc/examine
=x11-wm/e-9999 -*
dev-util/e_utils -*
dev-libs/engrave -* |
if you had no /etc/portage/package.keywords you do now  next you'll need to
| Code: | | emerge --sync && emerge --deep -u world |
while emerge does its thing, surf the web, grab a bite to eat, or go take a shower  for me those packages took about 30-45 minutes - if you have problems then I suggest you look here as any problems you have are most likely there - be warned that at times the sourceforge cvs repository goes offline... 
For non-gentoo
Ok, you've actually got quite a bit of work ahead of you unfortunately (unless some smart user has scripted something to grab the source and compile for you).
First we'll grab the source from CVS (you'll need a CVS app installed e.g. cvs from http://www.cvshome.org and a ~/.cvspass - should get created on first use)
| Code: | | cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/enlightenment login |
when prompted for password hit enter
| Code: | | cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/enlightenment co module/name |
where module/name corresponds to the following
| Code: |
misc/engage
e17/libs/esmart
e17/libs/imlib2
e17/libs/edje
e17/libs/ecore
e17/libs/evas
e17/libs/ewl
e17/libs/eet
e17/libs/edb
e17/libs/embryo
e17/libs/epsilon
e17/libs/epeg
e17/libs/etox
e17/libs/engrave
e17/apps/examine
e17/apps/e_utils
|
alternatively you could just pull in e17/libs and /apps along with misc/engage and then throw away what you don't need 
ok, now to compile, make sure you do this in order - first check that you have the e17 folder in ~/
| Code: |
cd e17/libs
cd imlib2
./autogen.sh
make
make install
cd ../
|
and the same for
| Code: |
edb
eet
evas
ecore
epsilon
embryo
edje
esmart
etox
ewl
epeg
engrave (in e17/apps)
examine (in e17/apps)
e_utils (in e17/apps)
engage (in ~/misc/engage)
|
don't forget to
as su
also in the gentoo forums thread linked above some people found they needed to specify their automake version (see p6 of that thread)
if you got through that unscathed, try the following
| Code: |
engage -e software -t gant -B 0 -s 48 -H 164
|
(engage -h will show you other options)
you should see the dock with a bunch of green question marks
if you right click you should see the configuration dialogue, click configuration to fire up examine - for now there's not much this will do as we haven't yet given engage any themes or icons to play with.
Make your own launchers
A lot of people have struggled with this step, myself included, partly because the enlightenment people changed the software to handle icons - this could happen again, it is development code right now.
First things first, create in your home directory the following
| Code: |
.e/
.e/apps/
.e/apps/engage/
.e/apps/engage/launcher/
.e/apps/engage/themes/
|
next grab the icon template from here and extract it to ~/
| Code: |
gunzip icon_template.tar.gz
tar -xvzf icon_template.tar.gz
|
you should now have the following files in ~/icon
| Code: |
build.sh
icon.eapp
icon.edc
icon.png
|
this is an example launcher for the gimp - before you can proceed you'll need to grab your own icons for your launchers - if you like what you have in /usr/share/icons great otherwise have a look around, there's lots of good iconsets and tutorials for converting mac/win icons to png too.
1. Replace icon.png with your own icon, rename it as icon.png.
2. Now you need to edit the build.sh as follows
| Code: |
#!/bin/sh
# actually compile a edje file with all the gfx etc.
edje_cc $@ -id . -fd . icon.edc icon.eapp
# add eapp properties to the file - they are ALL optional EXCEPT name and exe
# and exe is optional for directory .eapp files
enlightenment_eapp \
icon.eapp \
-set-name "NAME YOU WANT THE LAUNCHER TO DISPLAY" \
-set-generic "" \
-set-comment "COMMENT ON THE PROGRAM (IS NOT USED YET AFAIK)" \
-set-exe "THE BINARY OF THE PROGRAM (WITH PATH)" \
-set-win-class "THE WINDOW CLASS"
|
basically you can enter what you like in any of those except -set-win-class - here you'll have to supply the correct window class. To find out you'll need to use
then when cross-hair comes up, click on the border of the application in question e.g. evolution: this gave me Evolution-2.0
the path for -set-exe was "/usr/bin/evolution-2.0"
3. After you have edited build.sh execute it so:
congratulations you have just created your first launcher
4. now you put it where engage can find it
| Code: |
mv icon.eapp ~/.e/apps/engage/launcher/evolution.eapp
|
repeat the process - in my screenshot you can see 9 launchers for my most commonly used apps, browser, mail, video, music, photos, terminal, irc, etc
If you run engage now, you should see your launchers in there - they'll zoom but not bounce yet.
If not, customizing the theme should take care of it
Customizing the theme
The following steps will whip your current engage into tidier shape.
1. grab the gant theme from here
2. extract it with tar -xvzf (for ease I created a ~/.e/temp directory
3. go to gant_engage-0.0.6/fonts directory and delete everything
4. grab VeraBd.ttf from here leave the VeraBd.ttf in the fonts directory
5. cd ../ to the gant_engage-0.06 directory and edit the gant_engage.edc file like so
| Code: |
fonts {
font, "VeraBd.ttf" "Edje.VeraBold";
}
|
and delete all lines starting with
| Code: | | GENERIC_ICON_MAPPING |
6. Now edit gant_engage-0.06/parts/name.edc like so
| Code: |
color, 255 255 255 255;
color2, 0 0 0 255;
text {
text, "";
font, "Edje.VeraBold";
size, 12;
fit, 0 0;
align, 0.5 1.0;
}
}
|
7. edit gant_engage-0.06/hashes/icon_mappings.edc - delete everything in here
8. in gant_engage-0.06/images delete all .png files except arrow.png
9. in the same images directory edit the images.edc so it only contains
| Code: | | image, "arrow.png" LOSSY 95%; |
10. change to the main gant_engage-0.06 directory and edit build_theme.sh like so
| Code: |
#!/bin/sh -e
THEME="gant_engage"
edje_cc -v -id ./images -fd ./fonts $THEME.edc $THEME.eet
cp $THEME.eet "/home/vrln/source/"
echo done
fi
|
11. run build_themes.sh
12. you should now have a new gant_engage.eet move it to ~/.e/apps/engage/themes
| Code: | | mv gant_engage.eet ~/.e/apps/engage/themes |
13. close engage (if it's running) and restart with the following
| Code: |
engage -e software -t gant -B 0 -T yes -i 1 -I 1 -s 48 -H 164
|
You should now have your own launchers bouncing on click and firing off your favourite apps . Play around with the parameters to get your preferred settings.
Credits
I did not discover how to do this - the steps above are taken from the following sources:
http://forums.gentoo.org/viewtopic.html?t=286617&highlight=engage
http://forums.gentoo.org/viewtopic.html?t=174279&highlight=engage
http://lude.net/edocs/engage.htm
|
|
