'''Enlightenment''' is a project to provide 'advanced graphic libraries, tools and environments'.

+

[[fr:Enlightenment]]

+

[[it:Enlightenment]]

+

{{Article summary start}}

+

{{Article summary text|The Enlightenment project provides useful libraries, a graphical environment and other applications as well as development tools for creating such applications. This article covers its installation, configuration, and troubleshooting.}}

+

{{Article summary heading|Overview}}

+

{{Article summary text|{{Graphical user interface overview}}}}

+

{{Article summary end}}

−

The Enlightenment project is split into 3 parts:

+

From the [http://trac.enlightenment.org/e/wiki/Enlightenment Enlightenment wiki]:

−

* Enlightenment DR16, The original release of the enlightenment window manager.

+

−

* Enlightenment DR17, The new replacement window manager for DR16.

+

:''The Enlightenment desktop shell provides an efficient yet breathtaking window manager based on the Enlightenment Foundation Libraries along with other essential desktop components like a file manager, desktop icons and widgets. It boasts an unprecedented level of theme-ability while still being capable of performing on older hardware or embedded devices.''

−

* Enlightenment Foundation Libraries, An expansion for extra libraries not part of the other two sections.

+

+

== Enlightenment Desktop Shell (formerly E17) ==

+

+

This is comprised of both the Enlightenment [[window manager]] and Enlightenment Foundation Libraries (EFL), which provide additional desktop environment features such as a toolkit, object canvas, and abstracted objects. It has been under development since 2005, but in February 2011 the core EFLs saw their first stable 1.0 release. Enlightenment the window manager was released as version 0.17.0 on December 21st 2012, along with the 1.7.4 release of the EFL libraries. Many people currently use Enlightenment as a day-to-day desktop environment without problems.

+

+

{{Warning|This page refers to both stable and development packages. Any PKGBUILD which ends with -svn as well as scripts like easy_e17.sh will use unstable development code. Use them at your own risk. Since the release of the EFL libraries and Enlightenment itself, it's no longer necessary and even discouraged to build from svn. "Unless you're developing E or willing to live bleeding edge, stay away from trunk."([http://sourceforge.net/mailarchive/message.php?msg_id&#61;30310890 source]) Unfortunately, many of the additional software packages have not been released and building from SVN is the only way to use them.}}

You might also want to install additional [[Fonts]]. You need at least 1 True Type Font.

+

+

If you need/want an Enlightenment package which is not (yet) available in [extra], see if it is available in the [[AUR]].

+

+

==== From the AUR ====

+

+

SVN PKGBUILDs which download and install the very latest development code are available in the [[AUR]] as {{AUR|enlightenment17-svn}} and it's dependencies.

+

+

==== Compiling with easy_e17.sh ====

+

{{ic|easy_e17.sh}} compiles E17 from source and installs it in {{ic|/opt/e17}}. It does not create packages and therefore does not install dependencies automatically and is not tracked by pacman.

+

+

# Get it from the [[AUR]]: {{AUR|easy-e17}}.

+

# Edit {{ic|/etc/easy_e17.conf}} if you want.

+

# Run it as user, so it downloads to ~/e17_src and builds as user, to install E17 (the script will immediately ask for your password so it can install in the end): {{bc|# easy_e17.sh -i}}

+

# Put {{ic|/opt/e17/bin}} in your {{ic|PATH}} by editing {{ic|/etc/profile}}. For example, you can add this line at the end of the file: {{bc|1=PATH="$PATH:/opt/e17/bin"}}

+

# If, after completing the install, xinitrc complains that it cannot find enlightenment upon starting, you may need to add these lines to the end of /etc/profile as well:{{bc|1=PYTHONPATH=":$PYTHONPATH"}}{{bc|1=LD_LIBRARY_PATH="$LD_LIBRARY_PATH:/opt/e17/lib"}}

+

+

If you encounter any errors while trying to install E17, first check to make sure it is not a dependency problem. If it is, install the dependency and continue installing e17.

+

+

To update all installed EFL/E17 components, run this command:

+

# easy_e17.sh -u

+

+

=== Starting ===

+

==== startx ====

+

If you use {{ic|startx}} or a simple [[Display Manager]] like XDM or [[SLiM]], add or uncomment the following command in [[xinitrc]]:

+

{{hc|~/.xinitrc|

+

exec enlightenment_start

+

}}

+

+

==== Entrance ====

+

Nowadays E17 has a new display manager called Entrance, you can download it from AUR {{AUR|entrance-svn}}.

+

Entrance is quite sophisticated and its configuration is controlled by {{ic|/etc/entrance.conf}}.

+

To use Entrance :

+

+

# systemctl enable entrance

+

+

==== Other ====

+

More advanced display managers like [[GDM]] and [[KDM]] will automatically detect E17 thanks to the {{ic|/usr/share/xsessions/enlightenment.desktop}} file provided by the {{pkg|enlightenment17}} package.

+

+

=== Configuring the Network ===

+

+

==== ConnMan ====

+

+

E17's preferred network manager is [[Connman|ConnMan]]. It is available from the [community] repository as the {{Pkg|connman}} package. For extended configuration, you may also install EConnman (available in AUR as {{AUR|econnman-svn}}) and it's associated dependencies.

+

+

Finally, configure systemd to start the ConnMan daemon at startup:

+

+

systemctl enable connman

+

+

ConnMan loads very quickly and appears to handle DHCP quite nicely. If you have installed [[Wpa_supplicant]], ConnMan latches onto that shows all available wireless connections.

+

+

==== NetworkManager ====

+

+

You can also use {{Pkg|networkmanager}} to manage your network connections.

+

+

pacman -S networkmanager

+

+

Follow the instructions on [[NetworkManager]] to do the configuration. You may also need {{Pkg|network-manager-applet}} to help with your settings.

+

+

pacman -S network-manager-applet

+

+

You may want to add it to the start up programs so every time your E17 starts it appears on systray.

* [http://exchange.enlightenment.org/ exchange.enlightenment.org], for which you can use the {{AUR|e17-themes}} [[AUR]] package

+

* [http://www.e17-stuff.org e17-stuff.org]

+

* [http://relighted.c0n.de/#100 relighted.c0n.de] for the default theme in 200 different colors

+

* [http://trac.enlightenment.org/e/browser/trunk/THEMES svn trunk] (svn checkout the theme you like, run 'make' and you end up with a .edj theme file)

+

+

You can install the themes (coming in .edj format) using the theme configuration dialog or by moving them to {{ic|~/.e/e/themes}}.

+

+

{{Note|During 2010 there was a change in how themes work, so older themes will not work unless they were updated. There used to be an edje_convert tool to do this, but that has been dropped long ago (see: [http://trac.enlightenment.org/e/changeset/56156 trac.enlightenment.org])}}

+

+

=== Modules and Gadgets ===

+

;Module:Name used in enlightenment to refer to the "backing" code for a gadget.

+

;Gadget:Front-end or user interface that should help the end users of Enlightenment do something.

+

+

Many Modules provide Gadgets that can be added to your desktop or on a shelf. Some Modules (such as CPUFreq) only provide a single Gadget while others (such as Composite) provide additional features without any gadgets. Note that certain gadgets such as Systray can only be added to a shelf while others such as Moon can only be loaded on the desktop.

+

+

==== Compositing ====

+

E17 offers two modules for compositing, '''''Composite''''' and '''''Ecomorph''''', depending on your hardware and preference.

+

+

====== Composite ======

+

The ''Composite'' module is the standard compositing manager provided in enlightenment. It provides some minimal compositing effects such as transparency, fade and shadow. Composite provides the more stable module and is supported on most hardware through either OpenGL or compositing software rendering. When the configuration is messed up and the settings windows can no longer be approached, configuration for the comp module can be reset by the hardcoded keybinding {{ic|Ctrl + Alt + Shift + Home}}.

+

+

====== Ecomorph ======

+

The ''Ecomorph'' module is a full-featured compositing manager which was ported from [[Compiz]] for E17. It can be downloaded from AUR {{AUR|ecomorph-git}}. Some experience instability with Ecomorph while others use it without a problem. Ecomorph requires 3D acceleration, while Composite does not. Development of ecomorph has been discontinued in favor of the official composite module, although some maintenance and bug fixing may still be done ([http://code.google.com/p/itask-module/wiki/Stuff source]).

+

+

{{Note|The ability to unload the Composite module and load Ecomorph has been removed in the latest development code. Starting with the e18 release, Ecomorph will be officially dead.}}

+

+

==== "Extra" modules ====

+

{{Warning|These are 3rd party modules and not officially supported by the Enlightenment developers. They are also pulled directly from SVN, so they are development code that may or may not work at any time. Use at your own risk.}}

+

These modules are available from the AUR, either as part of {{AUR|e-modules-extra-svn}} or as individual packages.

+

+

====== Places ======

+

From the current source code [http://trac.enlightenment.org/e/browser/trunk/E-MODULES-EXTRA/places/README README] for Places: ''This module manage the volumes device attached to the system.''

+

+

In other words, Places is a gadget that will help you browse files on various devices you might plug into your computer, like phones, cameras, or other various storage devices you might plug into the usb port.

+

+

Available from {{AUR|e17-places-svn}}

+

{{Note|This module is no longer required for auto-mounting external devices in e17}}

+

+

====== Scale Windows ======

+

The ''Scale Windows'' module, which requires compositing to be enabled, adds several features. The scale windows effect shrinks all open windows and brings them all into view. This is known in Mac OS X as "Exposé". The scale pager effect zooms out and shows all desktops as a wall, like the compiz expo plugin. Both can be added to the desktop as a gadget or bound to a key binding, mouse binding or screen edge binding.

+

+

Some people like to change the standard window selection key binding {{ic|ALT + Tab}} to use Scale Windows to select windows. To change this setting, you navigate to {{ic|Menu > Settings > Settings Panel > Input > Keys}}. From here, you can set any key binding you would like.

+

+

To replace the window selection key binding functionality with Scale Windows, scroll through the left panel until you find the "ALT" section and then find and select {{ic|ALT + Tab}}. Then, scroll through the right panel looking for the "Scale Windows" section and choose either {{ic|Select Next}} or {{ic|Select Next (All)}} depending on whether you would like to see windows from only the current desktop or from all desktops and click "Apply" to save the binding.

+

+

Available from {{AUR|comp-scale-svn}}

+

+

====== Engage ======

+

Engage is CairoDock/GLX-Dock style docking bar for both application launchers and open applications. It requires compositing to be enabled and has full controls for transparency, size, zoom levels, and more.

+

+

Available from {{AUR|engage-svn}}

+

+

=== Gnome Keyring integration ===

+

+

It is possible to use gnome-keyring in e17. However at the time of writing you need a small hack to make it work in full.

+

First you must tell e17 to autostart gnome-kering. For that you should go to {{ic|Settings Panel > Apps > Startup Applications}} and activate "Certificate and Key Storage", "GPG Password Agent", "SSH Key Agent" and "Secret Storage Service".

+

After this you should edit your {{ic|~/.profile}} and add the following:

+

+

if [ -n "$GNOME_KEYRING_PID" ]; then

+

eval $(gnome-keyring-daemon --start)

+

export SSH_AUTH_SOCK

+

export GNOME_KEYRING_CONTROL

+

export GPG_AGENT_INFO

+

fi

+

+

This should export the variables you need for your key management at your next login.

+

+

=== Troubleshooting ===

+

+

If you find some unexpected behavior, there are a few things you can do:

+

# try to see if the same behavior exists with the default theme

+

# disable any 3rd party modules you may have installed

+

# backup {{ic|~/.e}} and remove it (e.g. {{ic|mv ~/.e ~/.e.back}})

+

+

If you are sure you found a bug please report it directly upstream. http://trac.enlightenment.org/e/report

+

+

==== Screen unlocking does not work ====

+

+

If screenlock does not accept your password add the following to {{ic|/etc/pam.d/enlightenment}}:

+

auth required pam_unix_auth.so

+

+

==== Unreadable fonts ====

+

+

If fonts are too small and your screen is unreadable, be sure the right font packages are installed:

Enlightenment, Development Release 16 was first released in 2000, and its most recent release was in 2003. It is said to be still under development today.

+

Enlightenment, Development Release 16 was first released in 2000, and went 1.0 in 2009. It is still under development today, regularly updated by its maintainer Kim 'kwo' Woelders. With compositing, shadows and transparencies, E DR16 kept all of the speed but with up to date refinement.

=== To install E16 ===

=== To install E16 ===

Line 15:

Line 209:

# pacman -S enlightenment

# pacman -S enlightenment

−

== Enlightenment DR17 ==

+

E can be quite different from the other WM's out there, read '''/usr/share/doc/e16/e16.html''' after installation to learn more

−

* Main article: [[e17]]

+

The man page is at 'man e16' , not 'man enlightenment', and only gives startup options.

+

+

=== Basic Configuration ===

+

+

Most everything in E DR16 resides in ~/.e16 and is text-based, editable at will. That includes the Menus too.

+

+

Shortcut keys can be either modified by hand, or with the e16keyedit software provided as source on the [http://sourceforge.net/projects/enlightenment/ sourceforge] page of the e16 project, or from the [https://aur.archlinux.org/packages.php?ID=20751 AUR].

+

+

==== Background images ====

+

+

You have to copy the desired wallpapers into ~/.e16/backgrounds/

+

+

MMB or RMB anywhere on the desktop will give access to the settings, select /Desktop/Backgrounds/

−

Under Heavy development, constantly changing in SVN. Snapshots have been taken for the Arch Community Repositories, for easy installation and compatibility with the different parts.

+

Any new item copied there will get the list auto-updated. Select desired wallpaper from drop-down menu. In side the apropriate tabs in the global e16 settings you can adjust things like tiling of the background image, filling screen and such.

−

==== Also included in the E17 Section ====

+

==== Start/Restart/Stop Scripts ====

−

* Entice &ndash; Image Viewer.

−

* Entrance &ndash; the Enlightement Desktop Manager.

−

* Evidence &ndash; Enlightened file manager.

−

* ERSS &ndash; For RSS feeds

−

* Eplayer &ndash; The Enlightened media player.

−

== Enlightenment Foundation Libraries ==

+

Create a Init , Start and Stop folders in your ~/.e16 folder: any .sh script found there will either be executed at Startup (from Init folder), at each Restart (from Start folder), or at Shutdown (from Stop folder); provided you allowed it trough the MMB / settings / session / <enable scripts> button and made them executable with ''chmod +x '''yourscript.sh'''''.

−

A set of libraries for expansion on the enlightenment base.

−

==== Libraries & What they are for ====

+

==== Compositor ====

−

* Imlib(2) &ndash; Image rendering and Manipulation LIBrary.

−

* EDB &ndash; E DataBase wrapper

−

* EET &ndash; Distrobution Container Libraries and Tools

−

* Evas &ndash; Canvas Library

−

* Ecore &ndash; For event abstraction and Modular Convenience

−

* Epeg &ndash; For thumbnailing JPEGs

−

* Epsilon &ndash; Freedesktop.org thumbnaiing library

−

* Etox &ndash; Text Layout and Manipulation

−

* Edje &ndash; Interface Abstraction Library & Tools

−

* Embryo &ndash; The embeddable scripting language for E

−

* EWL &ndash; Enlightenment Widget Library

−

* Emotion &ndash; Video smart-object library for Evas

−

==== Programs Developed with these libraries ====

+

Shadows, Transparent effects ''et all'' can be found in MMB or RMB /Settings, under Composite .

Revision as of 12:15, 5 February 2013

The Enlightenment desktop shell provides an efficient yet breathtaking window manager based on the Enlightenment Foundation Libraries along with other essential desktop components like a file manager, desktop icons and widgets. It boasts an unprecedented level of theme-ability while still being capable of performing on older hardware or embedded devices.

Enlightenment Desktop Shell (formerly E17)

This is comprised of both the Enlightenment window manager and Enlightenment Foundation Libraries (EFL), which provide additional desktop environment features such as a toolkit, object canvas, and abstracted objects. It has been under development since 2005, but in February 2011 the core EFLs saw their first stable 1.0 release. Enlightenment the window manager was released as version 0.17.0 on December 21st 2012, along with the 1.7.4 release of the EFL libraries. Many people currently use Enlightenment as a day-to-day desktop environment without problems.

Warning: This page refers to both stable and development packages. Any PKGBUILD which ends with -svn as well as scripts like easy_e17.sh will use unstable development code. Use them at your own risk. Since the release of the EFL libraries and Enlightenment itself, it's no longer necessary and even discouraged to build from svn. "Unless you're developing E or willing to live bleeding edge, stay away from trunk."(source) Unfortunately, many of the additional software packages have not been released and building from SVN is the only way to use them.

Starting

startx

Entrance

Nowadays E17 has a new display manager called Entrance, you can download it from AUR entrance-svnAUR.
Entrance is quite sophisticated and its configuration is controlled by /etc/entrance.conf.
To use Entrance :

# systemctl enable entrance

Other

More advanced display managers like GDM and KDM will automatically detect E17 thanks to the /usr/share/xsessions/enlightenment.desktop file provided by the enlightenment17 package.

Configuring the Network

ConnMan

E17's preferred network manager is ConnMan. It is available from the [community] repository as the connman package. For extended configuration, you may also install EConnman (available in AUR as econnman-svnAUR) and it's associated dependencies.

Finally, configure systemd to start the ConnMan daemon at startup:

systemctl enable connman

ConnMan loads very quickly and appears to handle DHCP quite nicely. If you have installed Wpa_supplicant, ConnMan latches onto that shows all available wireless connections.

svn trunk (svn checkout the theme you like, run 'make' and you end up with a .edj theme file)

You can install the themes (coming in .edj format) using the theme configuration dialog or by moving them to ~/.e/e/themes.

Note: During 2010 there was a change in how themes work, so older themes will not work unless they were updated. There used to be an edje_convert tool to do this, but that has been dropped long ago (see: trac.enlightenment.org)

Modules and Gadgets

Module

Name used in enlightenment to refer to the "backing" code for a gadget.

Gadget

Front-end or user interface that should help the end users of Enlightenment do something.

Many Modules provide Gadgets that can be added to your desktop or on a shelf. Some Modules (such as CPUFreq) only provide a single Gadget while others (such as Composite) provide additional features without any gadgets. Note that certain gadgets such as Systray can only be added to a shelf while others such as Moon can only be loaded on the desktop.

Compositing

E17 offers two modules for compositing, Composite and Ecomorph, depending on your hardware and preference.

Composite

The Composite module is the standard compositing manager provided in enlightenment. It provides some minimal compositing effects such as transparency, fade and shadow. Composite provides the more stable module and is supported on most hardware through either OpenGL or compositing software rendering. When the configuration is messed up and the settings windows can no longer be approached, configuration for the comp module can be reset by the hardcoded keybinding Ctrl + Alt + Shift + Home.

Ecomorph

The Ecomorph module is a full-featured compositing manager which was ported from Compiz for E17. It can be downloaded from AUR ecomorph-gitAUR. Some experience instability with Ecomorph while others use it without a problem. Ecomorph requires 3D acceleration, while Composite does not. Development of ecomorph has been discontinued in favor of the official composite module, although some maintenance and bug fixing may still be done (source).

Note: The ability to unload the Composite module and load Ecomorph has been removed in the latest development code. Starting with the e18 release, Ecomorph will be officially dead.

"Extra" modules

Warning: These are 3rd party modules and not officially supported by the Enlightenment developers. They are also pulled directly from SVN, so they are development code that may or may not work at any time. Use at your own risk.

These modules are available from the AUR, either as part of e-modules-extra-svnAUR or as individual packages.

Places

From the current source code README for Places: This module manage the volumes device attached to the system.

In other words, Places is a gadget that will help you browse files on various devices you might plug into your computer, like phones, cameras, or other various storage devices you might plug into the usb port.

Note: This module is no longer required for auto-mounting external devices in e17

Scale Windows

The Scale Windows module, which requires compositing to be enabled, adds several features. The scale windows effect shrinks all open windows and brings them all into view. This is known in Mac OS X as "Exposé". The scale pager effect zooms out and shows all desktops as a wall, like the compiz expo plugin. Both can be added to the desktop as a gadget or bound to a key binding, mouse binding or screen edge binding.

Some people like to change the standard window selection key binding ALT + Tab to use Scale Windows to select windows. To change this setting, you navigate to Menu > Settings > Settings Panel > Input > Keys. From here, you can set any key binding you would like.

To replace the window selection key binding functionality with Scale Windows, scroll through the left panel until you find the "ALT" section and then find and select ALT + Tab. Then, scroll through the right panel looking for the "Scale Windows" section and choose either Select Next or Select Next (All) depending on whether you would like to see windows from only the current desktop or from all desktops and click "Apply" to save the binding.

Engage

Engage is CairoDock/GLX-Dock style docking bar for both application launchers and open applications. It requires compositing to be enabled and has full controls for transparency, size, zoom levels, and more.

Gnome Keyring integration

It is possible to use gnome-keyring in e17. However at the time of writing you need a small hack to make it work in full.
First you must tell e17 to autostart gnome-kering. For that you should go to Settings Panel > Apps > Startup Applications and activate "Certificate and Key Storage", "GPG Password Agent", "SSH Key Agent" and "Secret Storage Service".
After this you should edit your ~/.profile and add the following:

Enlightenment DR16

Enlightenment, Development Release 16 was first released in 2000, and went 1.0 in 2009. It is still under development today, regularly updated by its maintainer Kim 'kwo' Woelders. With compositing, shadows and transparencies, E DR16 kept all of the speed but with up to date refinement.

To install E16

Simply run

# pacman -S enlightenment

E can be quite different from the other WM's out there, read /usr/share/doc/e16/e16.html after installation to learn more
The man page is at 'man e16' , not 'man enlightenment', and only gives startup options.

Basic Configuration

Most everything in E DR16 resides in ~/.e16 and is text-based, editable at will. That includes the Menus too.

Shortcut keys can be either modified by hand, or with the e16keyedit software provided as source on the sourceforge page of the e16 project, or from the AUR.

Background images

You have to copy the desired wallpapers into ~/.e16/backgrounds/

MMB or RMB anywhere on the desktop will give access to the settings, select /Desktop/Backgrounds/

Any new item copied there will get the list auto-updated. Select desired wallpaper from drop-down menu. In side the apropriate tabs in the global e16 settings you can adjust things like tiling of the background image, filling screen and such.

Start/Restart/Stop Scripts

Create a Init , Start and Stop folders in your ~/.e16 folder: any .sh script found there will either be executed at Startup (from Init folder), at each Restart (from Start folder), or at Shutdown (from Stop folder); provided you allowed it trough the MMB / settings / session / <enable scripts> button and made them executable with chmod +x yourscript.sh.

Compositor

Shadows, Transparent effects et all can be found in MMB or RMB /Settings, under Composite .