Introduction to Enlightenment DR17
What's Enlightenment DR17? (www.enlightenment.org)
So far it seems to stand somewhere between being a Window Manager and a Desktop Enviroment. As WM, being built on top of the Enlightenment Foundation Libraries, it's a fast one, and also quite lightweight considering all the bundled eye-candy.
As DE, there're several applications that might be part of the final DR17 release:
-Entrance (display manager)
-Evidence (file browser)
-Elicit (graphics examiner, with color picker and zoom)
-Entice (image viewer)
-Erss (rss app)
-Engage (dock app)
-Eclair (media player)
-Emblem
-Entangle (gui for editing menus, engage, ibar and startup apps)
Installation
You'll need to install the EFL in order to install E, and you also have to install those libraries in a specific order:
1. e17/libs/eet
2. e17/libs/edb
3. e17/libs/evas
4. e17/libs/ecore
5. e17/libs/embryo
6. e17/libs/imlib2
7. e17/libs/edje
8. e17/libs/epeg
9. e17/libs/epsilon
10. e17/libs/esmart
11. e17/libs/emotion (note that you'll need to have xine-lib installed as emotion uses it)
12. e17/libs/engrave (this is currently needed for e_utils only)
13. e17/libs/ewl (also needed for e_utils)
14. e17/libs/etox (this is only needed if you want to install eRSS, otherwise you can ignore etox)
Check this for instructions on how to access the Enlightenment anonymous CVS:
http://enlightenment.org/Enlightenment/Get...ment/index.html
These are the apps that run on top of the EFL:
* e17/apps/entice (image viewer)
* e17/apps/entrance (login manager)
* e17/apps/eclair (media player)
* e17/apps/e (E17 windowmanager)
* misc/engage (dockbar and E17 module)
* misc/erss (RSS feed application)
* e17/apps/e_utils (user-friendly utilities for the E17 WM)
* e17/apps/e_modules (additional modules for the E17 WM, note that this does NOT include the Engage module)
Basic layout and usage
Much like other WM such as fluxbox, there's no button to open the menu. All the menus are opened by clicking on the desktop:
-Left click: opens the main menu

-Right click: opens the "favorite applications" menu.

-Middle click: opens the "windows" menu. This allows to easily find any existing window: visible apps have the checkbox checked, minimized apps have it unchecked. Checking/unchecking that box will show/hide the selected app.

Editing the menus can be done either through a gui or editing text files:
a) Using the GUI:
Left click on the desktop and go to Configuration->Menu Editor. Entangle will open.

Select the item you want to edit on the top of the app (Favorites, iBar, Engage, Startup, Restart). A list of the current apps and submenus will be displayed, along with a list on the left with all the available icons which can be added.
To add a new icon just drag and drop. To remove an icon, middle click on it. To add a submenu just click on the "Add Dir" button at the bottom of the app window.
b) Editing text files:
Menus' settings are stored in the directories inside ~/.e/e/applications/
Inside each directory will be an .order file which looks like this:
QUOTE
games
firefox.eap
sylpheed-claws.eap
amule.eap
gimp.eap
rhythmbox.eap
firefox.eap
sylpheed-claws.eap
amule.eap
gimp.eap
rhythmbox.eap
Each .eap item launches an application, and items without extension are directories. In the example above, that .order file would be in ~/.e/e/applications/favorite and we would have a ~/.e/e/applications/favorite/games directory with it's own .order file inside.
Icons and background
E17 uses it's own binary format for icons and background images.
Icons are stored inside .eap files. Those files contain both the icon and info regarding the application which will be launched when clicking on it. That info is also used to identify running apps and show their icons on the dock.
All available eap files are stored in ~/.e/e/applications/all. If you download a pack of eap files, that's where you have to extract it.
There're several icon themes available at get-e.org, but we can also create our own icons using e_util_eapp_edit. Just launch the application specifying the name of the eap file you want to create/modify, and a gui will pop up.

Another way to create eap icons for applications is left-clicking on the upper left border of the application window and going to the "Edit icon" option in the pop up menu.
Backgrounds are stored in the edj binary format. Edj files can store several images with transparencies and display them in layers. You can also animate those layers.
To create an edj file from any image, use e17setroot:
e17setroot -s /home/username/picture.png
The line above will create and edj file from picture.png and set it as background on all desktops.
If you already have several edj files, you can manage them with Emblem:

Modules
Most of the addons that spice up E17 are built as modules. Some of them might do it into the final release and some might be droped along the way. Currently there're 8 modules loaded by default, and some more that can be loaded manually. The most interesting one out of the later ones is engage. To load it execute:
enlightenment_remote -module-load engage
You can also try the snow and flame modules. Once loaded it will always load (loading doesn't mean activating, they will only be running if you left them that way on logout) on startup unless you manually unload them
enlightenment_remote -module-unload <modulename>
All loaded modules can be enabled/disabled and configured from the menu:

To move and resize modules you have to put them in edit mode, either using the option in the menu->gadgets->Edit Mode, or right clicking on a module and choosing the Edit Mode option in the pop up menu. Hadles will appear around the modules so you can resize them:

Themes
Themes are also in edj format. To add new themes copy the .edj files to ~/.e/e/themes.
You can select the theme to be used in the menu->themes
If you feel like extracting the contents of the theme, you'll have to decompile it using one of the tools bundled:
edje_decc filename.edj
A new folder will be created, and all the theme elements will be put inside. There'll also be an script to re-compile the theme inside that directory (build.sh), which can be useful to make your own custom themes modifying existing ones.
Transparency
There's no support for fake transparency (eg. on consoles) as the point seems to be to implement real transparency later on when HW acceleration gets implemented, so you'll have to use a little hack to get that: use Esetroot <imagefile> to set a fake background, which won't be visible but that's what will appear as background in fake "transparencies". Obviously you'll want to set as fake background the same image you're using as background.
Being a nasty hack as it is, it wont work with animated backgrounds.
Note: E17 is still under development, and the way some things work might change in next versions.



