Difference between revisions of "Enlightenment"

From ArchWiki
Jump to: navigation, search
(Described wrong effect.)
m (Default Keybindings: changed a description)
 
(142 intermediate revisions by 32 users not shown)
Line 1: Line 1:
[[Category:Desktop environments]]  
+
[[Category:Desktop environments]]
 
[[cs:Enlightenment]]
 
[[cs:Enlightenment]]
 +
[[de:Enlightenment]]
 +
[[es:Enlightenment]]
 
[[fr:Enlightenment]]
 
[[fr:Enlightenment]]
 
[[it:Enlightenment]]
 
[[it:Enlightenment]]
{{Article summary start}}
+
[[ja:Enlightenment]]
{{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.}}
+
[[lt:Enlightenment]]
{{Article summary heading|Overview}}
+
[[pl:Enlightenment]]
{{Article summary text|{{Graphical user interface overview}}}}
+
[[ru:Enlightenment]]
{{Article summary end}}
+
[[zh-cn:Enlightenment]]
 +
{{Related articles start}}
 +
{{Related|Desktop environment}}
 +
{{Related|Display manager}}
 +
{{Related|Window manager}}
 +
{{Related articles end}}
  
From the [http://trac.enlightenment.org/e/wiki/Enlightenment Enlightenment wiki]:
+
== Enlightenment ==
  
:''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.''
+
This comprises both the [https://www.enlightenment.org/ 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 Desktop Shell (formerly E17) ==
+
=== Installation ===
  
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.
+
Enlightenment can be [[installed]] with the package {{Pkg|enlightenment}}.
  
{{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=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 {{Pkg|terminology}}, which is an EFL-based terminal emulator that integrates well with Enlightenment.
  
=== Installing ===
+
==== From the AUR ====
  
==== From the extra repository ====
+
{{Warning|Some of these PKGBUILDs use unstable development code. Use them at your own risk.}}
  
To install Enlightenment, install the {{Pkg|enlightenment17}} package.
+
Development PKGBUILDs which download and install the very latest development code are available as {{AUR|enlightenment-git}} and its dependencies.
  
You might also want to install additional [[Fonts]]. You need at least 1 True Type Font.
+
The following are EFL-based applications, most in an early stage of development and not yet released:
 +
* {{AUR|econcentration-git}}{{Broken package link|{{aur-mirror|econcentration-git}}}} – Econcentration card game
 +
* {{AUR|ecrire-git}} – Ecrire text editor
 +
* {{AUR|elbow-git}} – Elbow web browser
 +
* {{AUR|eluminance-git}} – Eluminance photo browser
 +
* {{AUR|emprint-git}}{{Broken package link|{{aur-mirror|emprint-git}}}} – Emprint screenshot tool
 +
* {{AUR|enjoy-git}} – [https://trac.enlightenment.org/e/wiki/Enjoy Enjoy] music player
 +
* {{AUR|epad}} – ePad text editor
 +
* {{AUR|eperiodique}} – [http://eperiodique.sourceforge.net/ Eperiodique] periodic table viewer
 +
* {{AUR|ephoto-git}} – [https://trac.enlightenment.org/e/wiki/Ephoto Ephoto] picture viewer
 +
* {{AUR|epour}}{{Broken package link|{{aur-mirror|epour}}}} and {{AUR|epour-git}}{{Broken package link|{{aur-mirror|epour-git}}}} – Epour Bittorrent client
 +
* {{AUR|epymc-git}} – E Python Media Center
 +
* {{AUR|equate-git}} – Equate calculator
 +
* {{AUR|eruler-git}} – Eruler on-screen ruler and measurement tools
 +
* {{AUR|efbb-git}} – Escape from Booty Bay angry birds style game
 +
* {{AUR|elemines-git}} – [http://elemines.sourceforge.net/ Elemines] minesweeper style game
 +
* {{AUR|espionage-git}} – Espionage D-Bus inspector
 +
* {{AUR|ev-git}} – ev simple picture viewer
 +
* {{AUR|e_cho-git}}{{Broken package link|{{aur-mirror|e_cho-git}}}} – E_Cho simon style game
 +
* {{AUR|e_jeweled-git}}{{Broken package link|{{aur-mirror|e_jeweled-git}}}} – E_Jeweled bejeweled style game
 +
* {{AUR|rage}} and {{AUR|rage-git}} – Rage video player
 +
* {{AUR|jesus-git}} – A filemanager based on Elementary and EFL
  
If you need/want an Enlightenment package which is not (yet) available in [extra], see if it is available in the [[AUR]].
+
=== Starting Enlightenment ===
  
==== From the AUR ====
+
Simply choose ''Enlightenment'' session from your favourite [[display manager]] or configure [[xinitrc]] to start it from the console.
  
SVN PKGBUILDs which download and install the very latest development code are available in the [[AUR]] as {{AUR|enlightenment17-svn}} and it's dependencies.
+
==== Entrance ====
  
==== Compiling with easy_e17.sh ====
+
{{Warning|Entrance is highly experimental, and does not have proper systemd support. Use it at your own risk.}}
{{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}}.
+
Enlightenment has a new display manager called Entrance, which is provided by the {{AUR|entrance-git}} package. Entrance is quite sophisticated and its configuration is controlled by {{ic|/etc/entrance.conf}}. It can be used by enabling {{ic|entrance.service}} [[systemd#Using units|using systemd]].
# 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.
+
==== Starting Enlightenment manually ====
  
To update all installed EFL/E17 components, run this command:
+
If you prefer to start Enlightenment manually from the console, add the following line to your {{ic|~/.xinitrc}} file:
# 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|
 
{{hc|~/.xinitrc|
 
exec enlightenment_start
 
exec enlightenment_start
 
}}
 
}}
  
==== Entrance ====
+
After that Enlightenment can be launched by typing {{ic|startx}}. See [[xinitrc]] for details.
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
+
=== Configuration ===
  
==== Other ====
+
Enlightenment has a sophisticated configuration system that can be accessed from the Main menu's Settings submenu.
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 ===
+
==== Network ====
  
==== ConnMan ====
+
'''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.
+
Enlightenment's preferred network manager is [[Connman|ConnMan]] which can be installed from the {{Pkg|connman}} package. Follow the instructions on [[Connman]] to do the configuration.
  
Finally, configure systemd to start the ConnMan daemon at startup:
+
For extended configuration, you may also install Econnman (available in AUR as {{AUR|econnman}} or {{AUR|econnman-git}}) and its associated dependencies.
  
systemctl enable connman
+
'''Adding the ConnMan Gadget to the Shelf'''
  
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.
+
# Settings -> Extensions -> Modules
 +
# under System
 +
# Connection Manager
 +
# Load that (select then hit ''Load'').
 +
# Right-click on the shelf at the bottom of the screen.
 +
# Go to Shelf -> Contents
 +
# Then, just scroll around and find ''ConnMan''.
 +
# and hit ''Add''.
  
==== NetworkManager ====
+
'''NetworkManager'''
  
You can also use {{Pkg|networkmanager}} to manage your network connections.
+
You can also use {{Pkg|networkmanager}} to manage your network connections. Follow the instructions on [[NetworkManager]] to do the configuration.
  
pacman -S networkmanager
+
You probably also need {{Pkg|network-manager-applet}} to help with your settings. You may want to add it to the start up programs so every time Enlightenment starts it appears on systray. For that you should go to ''Settings Panel > Apps > Startup Applications > System'' and activate ''Network''.
  
Follow the instructions on [[NetworkManager]] to do the configuration. You may also need {{Pkg|network-manager-applet}} to help with your settings.
+
Whilst network connectivity will work, the applet itself will not be visible unless you have enabled the system tray, see [[#Enabling the system tray]].
  
pacman -S network-manager-applet
+
==== Polkit agent ====
  
You may want to add it to the start up programs so every time your E17 starts it appears on systray.
+
Enlightenment does not ship with a [[Polkit#Authentication agents|graphical polkit authentication agent]]. If you want to access some privileged actions (e.g. mount a filesystem on a system device), you have to install one and autostart it. For that you should go to ''Settings Panel > Apps > Startup Applications > System'' and activate it. There is an EFL based authentication agent available in the AUR, {{AUR|polkit-efl-git}}.
  
Settings -> Settings Panel -> Apps -> Startup Applications -> System -> Network
+
==== GNOME Keyring integration ====
  
=== Installing Themes ===
+
It is possible to use gnome-keyring in Enlightenment. However, at the time of writing, you need a small hack to make it work in full.
 +
First, you must tell Enlightenment to autostart gnome-keyring. For that you should go to ''Settings Panel > Apps > Startup Applications > System'' 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:
  
More themes to customize the look of e17 are available from:
+
        #Set gnome-keyring as the ssh authentication agent
* [http://exchange.enlightenment.org/ exchange.enlightenment.org], for which you can use the {{AUR|e17-themes}} [[AUR]] package
+
        export SSH_AUTH_SOCK=/run/user/${UID}/keyring/ssh
* [http://www.e17-stuff.org e17-stuff.org]
+
 
 +
This "hack" is used to override the automatic setting of the variable by "enlightenment-start" from "ssh-agent" to gnome-keyring.
 +
 
 +
More information on this topic in the [[GNOME Keyring]] article.
 +
 
 +
==== Enabling the system tray ====
 +
 
 +
{{Note|Since Enlightenment 20, Xembed support has been removed [https://twitter.com/_enlightenment_/status/538000507315314688] meaning that many 'legacy' applets can no longer be displayed in the Systray. To use these applets, you will need to use a standalone system tray application such as {{Pkg|stalonetray}} instead.}}
 +
 
 +
Enlightenment has support for a system tray but it is disabled by default. To enable the system tray, open the Enlightenment main menu, navigate to the ''Settings'' submenu and click on the ''Modules'' option. Scroll down until you see the ''Systray'' option. Highlight that option and click the ''Load'' button. Now that the module has been loaded, it can be added to the shelf. Right click on the shelf you wish to add the Systray to, hightlight the ''Shelf'' submenu and click on the ''Contents'' option. Scroll down until you see ''Systray''. Highlight that option and click the ''Add'' button.
 +
 
 +
==== Notifications ====
 +
 
 +
Enlightenment provides a notification server through its Notification extension.
 +
* Notifications may be displayed in any corner of the "screen" as defined below
 +
* Available screen policies are Primary Screen, Current Screen, All Screens, and Xinerama
 +
* Notifications may be filtered based on urgency (Low, Normal, or Critical in any combination)
 +
* A default notification timeout may be set and optionally enforced for all notifications
 +
* The notification server may also optionally ignore replace ID requests
 +
 
 +
=== Themes ===
 +
 
 +
More themes to customize the look of Enlightenment are available from:
 +
* [http://exchange.enlightenment.org/theme exchange.enlightenment.org]
 +
* [http://e17-stuff.org/index.php?xcontentmode=7000 e17-stuff.org]
 
* [http://relighted.c0n.de/#100 relighted.c0n.de] for the default theme in 200 different colors
 
* [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)
+
* [http://git.enlightenment.org/themes git.enlightenment.org] (git clone the theme you like, run 'make' and you end up with a .edj theme file)
 +
* [http://packages.bodhilinux.com/bodhi/pool/stable/b/ packages.bodhilinux.com] has a good collection (you will need to extract the .edj file from the .deb; bsdtar will do this and is part of the base ArchLinux install). A nice catalog can be seen at [https://web.archive.org/web/20140120083020/http://art.bodhilinux.com/doku.php?id=bodhi_e17_themes_v3 their wiki].
  
 
You can install the themes (coming in .edj format) using the theme configuration dialog or by moving them to {{ic|~/.e/e/themes}}.  
 
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])}}
+
{{Note|Enlightenment does not provide a stable theme API, and there have been numerous theme API changes over the years, even after E17 was released. Themes that have not been updated regularly are unlikely to work.}}
 +
 
 +
{{Tip|1=To make GTK and Qt applications match the default theme of Enlightenment you can download a theme like the [http://gnome-look.org/content/show.php/?content=163472 E17 GTK theme], place it in {{ic|~/.themes/}} and select application themes from Enlightenments settings, and set it to that, this will make all GTK2 and GTK3 applications match the default Enlightenment theme, you can then configure Qt applications (or configure Qt's default settings) to use the Gtk+ theme so it will mimic the theme your GTK applications are using, this way you can make sure most applications will blend in perfectly with your default enlightenment theme. See also [[Uniform look for Qt and GTK applications]].}}
 +
 
 +
==== GTK+ ====
 +
 
 +
To alter the GTK+ theme, go to ''Settings > All > Look > Application Theme''.
  
 
=== Modules and Gadgets ===
 
=== Modules and Gadgets ===
 +
 
;Module:Name used in enlightenment to refer to the "backing" code for a gadget.   
 
;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.
 
;Gadget:Front-end or user interface that should help the end users of Enlightenment do something.
Line 108: Line 163:
 
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.  
 
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 ====
+
==== "Extra" modules ====
E17 offers two modules for compositing, '''''Composite''''' and '''''Ecomorph''''', depending on your hardware and preference.
+
  
====== Composite ======
+
{{Warning|These are 3rd party modules and not officially supported by the Enlightenment developers. They are also pulled directly from git, so they are development code that may or may not work at any time. Use at your own risk.}}
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}}.
+
Beyond the modules described here, more "extra" modules are available from {{AUR|e-modules-extra-git}}.
  
====== Ecomorph ======
+
'''Places'''
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 ======
+
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.
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|places-git}}.
 +
{{Note|This module is no longer required for auto-mounting  external devices in Enlightenment}}
  
Available from {{AUR|e17-places-svn}}
+
'''Scale Windows'''
{{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.   
 
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.   
+
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 ''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.
+
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 ''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.
  
Available from {{AUR|comp-scale-svn}}
+
Available from {{AUR|comp-scale-git}}{{Broken package link|{{aur-mirror|comp-scale-git}}}}.
  
====== 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}}
+
=== Default Keybindings ===
  
=== Gnome Keyring integration ===
+
{| class="wikitable"
 
+
|+ Some default Enlightenment keybindings
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.
+
| Shift + F10       
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".
+
| Maximize Vertically                           
After this you should edit your {{ic|~/.profile}} and add the following:
+
|-
 
+
| Ctrl + Menu       
  if [ -n "$GNOME_KEYRING_PID" ]; then
+
| Show "Clients" (windows) Menu                 
     eval $(gnome-keyring-daemon --start)
+
|-
     export SSH_AUTH_SOCK
+
| Alt + Escape       
     export GNOME_KEYRING_CONTROL
+
| Show "Everything Launcher" (apps, windows, etc)
     export GPG_AGENT_INFO
+
|-
  fi
+
| Win + Left         
 
+
| Maximize Left                                 
This should export the variables you need for your key management at your next login.
+
|-
 +
| Win + Right       
 +
| Maximize Right                                 
 +
|-
 +
| Alt + Shift + F10 
 +
| Maximize Horizontally                         
 +
|-
 +
| Alt + Shift + Left  
 +
| Flip to the Desktop on the Left               
 +
|-
 +
| Alt + Shift + Right
 +
| Flip to the Desktop on the Right               
 +
|-
 +
| Ctrl + Alt + D      
 +
| Show the desktop                               
 +
|-
 +
| Ctrl + Alt + F     
 +
| Toggle Fullscreen                             
 +
|-
 +
| Ctrl + Alt + I     
 +
| Toggle iconic mode                             
 +
|-
 +
| Ctrl + Alt + K     
 +
| Kill window
 +
|-
 +
| Ctrl + Alt + L      
 +
| Lock the desktop                               
 +
|-
 +
| Ctrl + Alt + N      
 +
| Maximize Window                               
 +
|-
 +
| Ctrl + Alt + R      
 +
| Toggle Shade up                               
 +
|-
 +
| Ctrl + Alt + W     
 +
| Window menu                                   
 +
|-
 +
| Ctrl + Alt + X     
 +
| Close a window                                 
 +
|-
 +
| Ctrl + Alt + Down 
 +
| Lower                                         
 +
|-
 +
| Ctrl + Alt + Up   
 +
| Raise                                         
 +
|-
 +
| Ctrl + Alt + Left 
 +
| Flip to desktop on left                       
 +
|-
 +
| Ctrl + Alt + Right  
 +
| Flip to desktop on right                       
 +
|-
 +
| Ctrl + Alt + Delete
 +
| End session dialog
 +
|-
 +
| Ctrl + Alt + Insert
 +
| Launch the default terminal                               
 +
|}
  
 
=== Troubleshooting ===
 
=== Troubleshooting ===
Line 167: Line 267:
 
# backup {{ic|~/.e}} and remove it (e.g. {{ic|mv ~/.e ~/.e.back}})
 
# 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
+
If you are sure you found a bug please report it [https://phab.enlightenment.org/maniphest/task/create/ directly upstream].
  
==== Screen unlocking does not work ====
+
==== Compositing ====
  
If screenlock does not accept your password add the following to {{ic|/etc/pam.d/enlightenment}}:
+
When the configuration needs to be reset and the settings windows can no longer be approached, configuration for the compositor can be reset using the hardcoded keybinding {{ic|Ctrl + Alt + Shift + Home}}.
auth required pam_unix_auth.so
+
  
 
==== Unreadable fonts ====
 
==== Unreadable fonts ====
  
If fonts are too small and your screen is unreadable, be sure the right font packages are installed:
+
If fonts are too small and your screen is unreadable, be sure the right font packages are installed. {{Pkg|ttf-dejavu}} and {{Pkg|ttf-bitstream-vera}} are valid candidates.
pacman -S ttf-dejavu ttf-bitstream-vera
+
  
==== Failure in mounting internal partitions ====
+
You can set scaling under ''Settings > Settings Panel > Look > Scaling''.
Check if user is in storage group:
+
{{bc|# groups <user>}}
+
  
If user is not in storage group:
+
==== Backlight always dimmed ====
{{bc|# groupadd storage
+
# gpasswd -a <user> storage}}
+
  
Then create this file as root:
+
You may find that Enlightenment routinely dims the backlight to 30% on logout and will only restore it to 100% when you log into another Enlightenment session. This is especially problematic when using another desktop environment alongside Enlightenment as the backlight will not automatically be restored to its normal level when using that desktop environment. To fix this issue, open the Enlightenment ''Settings Panel'' and, under the ''Look'' tab, click on the ''Composite'' option. Tick the ''Don't fade backlight'' box and click ''OK''.
{{bc|# nano /etc/polkit-1/localauthority/50-local.d/10-storage-group-mount-override.pkla}}
+
  
And write into the file:
+
==== Inconsistent cursor theme ====
  
[storage group mount override]
+
You may find that the cursor theme for the desktop is different to the one used in applications such as [[Firefox]]. This is because desktop applications are using X cursor themes whilst Enlightenment has its own set of cursor themes. For consistency, you can set Enlightenment to always use the X cursor theme. To do this, open the Enlightenment ''Settings Panel'' and click on the ''Input'' tab. Click on the ''Mouse'' option. Change the theme from ''Enlightenment'' to ''X'' and click ''OK''. You should now find that the same cursor theme is used everywhere. If the X cursor theme itself is not always consistent, see [[Cursor themes#XDG specification]].
Identity=unix-group:storage
+
Action=org.freedesktop.udisks2.filesystem-mount-system
+
ResultAny=yes
+
ResultInactive=yes
+
ResultActive=yes
+
 
+
For more information, see:
+
http://bbs.archbang.org/viewtopic.php?id=2720
+
  
 
== Enlightenment DR16 ==
 
== 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.
+
 
 +
Enlightenment, Development Release 16 was first released in 2000, and reached version 1.0 in 2009. Originally, the DR16 stood for the 0.16 version of the Enlightenment project. You'll find it as "Enlightenment16" now in the Arch repositories, it is still under development today, regularly updated by its maintainer Kim 'kwo' Woelders. With compositing, shadows and transparencies, E16 kept all of the speed that presided over its foundation by original author Carsten "Rasterman" Haitzler but with up to date refinement.
  
 
=== To install E16 ===
 
=== 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
+
Install {{Pkg|enlightenment16}}.
The man page is at 'man e16' , not 'man enlightenment', and only gives startup options.
+
 
 +
E16 can be quite different from the other WM's out there, read {{ic|/usr/share/doc/e16/e16.html}} after installation to learn more. The man page is at {{ic|man e16}}, not {{ic|man enlightenment}}, and only gives startup options.
  
 
=== Basic Configuration ===
 
=== Basic Configuration ===
  
Most everything in E DR16 resides in ~/.e16 and is text-based, editable at will. That includes the Menus too.
+
Most everything in E16 resides in {{ic|~/.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].
+
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 {{AUR|e16keyedit}}{{Broken package link|{{aur-mirror|e16keyedit}}}} package.
  
 
==== Background images ====
 
==== Background images ====
  
You have to copy the desired wallpapers into ~/.e16/backgrounds/
+
You have to copy the desired wallpapers into {{ic|~/.e16/backgrounds/}}
  
MMB or RMB anywhere on the desktop will give access to the settings, select /Desktop/Backgrounds/
+
MMB or RMB anywhere on the desktop will give access to the settings, select {{ic|/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.
+
Any new image copied in the {{ic|~/.e16/backgrounds/}} folder will get the list of available backgrounds auto-updated. Select desired wallpaper from drop-down menu. Inside the appropriate tabs in the global e16 settings, you can adjust things like tiling of the background image, filling screen and such.
  
 
==== Start/Restart/Stop Scripts ====
 
==== 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'''''.
+
Create an Init, a Start and a Stop folder in your {{ic|~/.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 {{ic|chmod +x '''yourscript.sh'''}}. Typical examples involves starting pulseaudio or your favorite network manager applet.
  
 
==== Compositor ====
 
==== Compositor ====
Line 234: Line 319:
 
Shadows, Transparent effects ''et all'' can be found in MMB or RMB /Settings, under Composite .
 
Shadows, Transparent effects ''et all'' can be found in MMB or RMB /Settings, under Composite .
  
== External Links ==
+
== See also ==
 
* [http://www.enlightenment.org/ Enlightenment Homepage]
 
* [http://www.enlightenment.org/ Enlightenment Homepage]
 
* [http://exchange.enlightenment.org/ Enlightenment Exchange]
 
* [http://exchange.enlightenment.org/ Enlightenment Exchange]
* [http://trac.enlightenment.org/e/wiki/EFL EFL User Guide]
+
* [http://docs.enlightenment.org/ Enlightenment Developer Documentation]
 
* [http://www.bodhilinux.com/e17guide/e17guideEN/ Bodhi Guide to Enlightenment]
 
* [http://www.bodhilinux.com/e17guide/e17guideEN/ Bodhi Guide to Enlightenment]
 
* [http://www.e17-stuff.org/ E17-Stuff]
 
* [http://www.e17-stuff.org/ E17-Stuff]
 
* [http://sourceforge.net/projects/enlightenment/ DR16 download resource]
 
* [http://sourceforge.net/projects/enlightenment/ DR16 download resource]
* [https://lists.sourceforge.net/lists/listinfo/enlightenment-users E-Users mail list]
+
* [https://lists.sourceforge.net/lists/listinfo/enlightenment-users Enlightenment users mail list]
* [https://lists.sourceforge.net/lists/listinfo/enlightenment-devel E-Devs mail list]
+
* [https://lists.sourceforge.net/lists/listinfo/enlightenment-devel Enlightenment developer mail list]
*irc://irc.freenode.net#e
+
* irc://irc.freenode.net#e

Latest revision as of 12:57, 22 March 2016

Enlightenment

This comprises 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.

Installation

Enlightenment can be installed with the package enlightenment.

You might also want to install terminology, which is an EFL-based terminal emulator that integrates well with Enlightenment.

From the AUR

Warning: Some of these PKGBUILDs use unstable development code. Use them at your own risk.

Development PKGBUILDs which download and install the very latest development code are available as enlightenment-gitAUR and its dependencies.

The following are EFL-based applications, most in an early stage of development and not yet released:

Starting Enlightenment

Simply choose Enlightenment session from your favourite display manager or configure xinitrc to start it from the console.

Entrance

Warning: Entrance is highly experimental, and does not have proper systemd support. Use it at your own risk.

Enlightenment has a new display manager called Entrance, which is provided by the entrance-gitAUR package. Entrance is quite sophisticated and its configuration is controlled by /etc/entrance.conf. It can be used by enabling entrance.service using systemd.

Starting Enlightenment manually

If you prefer to start Enlightenment manually from the console, add the following line to your ~/.xinitrc file:

~/.xinitrc
exec enlightenment_start

After that Enlightenment can be launched by typing startx. See xinitrc for details.

Configuration

Enlightenment has a sophisticated configuration system that can be accessed from the Main menu's Settings submenu.

Network

ConnMan

Enlightenment's preferred network manager is ConnMan which can be installed from the connman package. Follow the instructions on Connman to do the configuration.

For extended configuration, you may also install Econnman (available in AUR as econnmanAUR or econnman-gitAUR) and its associated dependencies.

Adding the ConnMan Gadget to the Shelf

  1. Settings -> Extensions -> Modules
  2. under System
  3. Connection Manager
  4. Load that (select then hit Load).
  5. Right-click on the shelf at the bottom of the screen.
  6. Go to Shelf -> Contents
  7. Then, just scroll around and find ConnMan.
  8. and hit Add.

NetworkManager

You can also use networkmanager to manage your network connections. Follow the instructions on NetworkManager to do the configuration.

You probably also need network-manager-applet to help with your settings. You may want to add it to the start up programs so every time Enlightenment starts it appears on systray. For that you should go to Settings Panel > Apps > Startup Applications > System and activate Network.

Whilst network connectivity will work, the applet itself will not be visible unless you have enabled the system tray, see #Enabling the system tray.

Polkit agent

Enlightenment does not ship with a graphical polkit authentication agent. If you want to access some privileged actions (e.g. mount a filesystem on a system device), you have to install one and autostart it. For that you should go to Settings Panel > Apps > Startup Applications > System and activate it. There is an EFL based authentication agent available in the AUR, polkit-efl-gitAUR.

GNOME Keyring integration

It is possible to use gnome-keyring in Enlightenment. However, at the time of writing, you need a small hack to make it work in full. First, you must tell Enlightenment to autostart gnome-keyring. For that you should go to Settings Panel > Apps > Startup Applications > System 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:

       #Set gnome-keyring as the ssh authentication agent
       export SSH_AUTH_SOCK=/run/user/${UID}/keyring/ssh

This "hack" is used to override the automatic setting of the variable by "enlightenment-start" from "ssh-agent" to gnome-keyring.

More information on this topic in the GNOME Keyring article.

Enabling the system tray

Note: Since Enlightenment 20, Xembed support has been removed [1] meaning that many 'legacy' applets can no longer be displayed in the Systray. To use these applets, you will need to use a standalone system tray application such as stalonetray instead.

Enlightenment has support for a system tray but it is disabled by default. To enable the system tray, open the Enlightenment main menu, navigate to the Settings submenu and click on the Modules option. Scroll down until you see the Systray option. Highlight that option and click the Load button. Now that the module has been loaded, it can be added to the shelf. Right click on the shelf you wish to add the Systray to, hightlight the Shelf submenu and click on the Contents option. Scroll down until you see Systray. Highlight that option and click the Add button.

Notifications

Enlightenment provides a notification server through its Notification extension.

  • Notifications may be displayed in any corner of the "screen" as defined below
  • Available screen policies are Primary Screen, Current Screen, All Screens, and Xinerama
  • Notifications may be filtered based on urgency (Low, Normal, or Critical in any combination)
  • A default notification timeout may be set and optionally enforced for all notifications
  • The notification server may also optionally ignore replace ID requests

Themes

More themes to customize the look of Enlightenment are available from:

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

Note: Enlightenment does not provide a stable theme API, and there have been numerous theme API changes over the years, even after E17 was released. Themes that have not been updated regularly are unlikely to work.
Tip: To make GTK and Qt applications match the default theme of Enlightenment you can download a theme like the E17 GTK theme, place it in ~/.themes/ and select application themes from Enlightenments settings, and set it to that, this will make all GTK2 and GTK3 applications match the default Enlightenment theme, you can then configure Qt applications (or configure Qt's default settings) to use the Gtk+ theme so it will mimic the theme your GTK applications are using, this way you can make sure most applications will blend in perfectly with your default enlightenment theme. See also Uniform look for Qt and GTK applications.

GTK+

To alter the GTK+ theme, go to Settings > All > Look > Application Theme.

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.

"Extra" modules

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

Beyond the modules described here, more "extra" modules are available from e-modules-extra-gitAUR.

Places

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 places-gitAUR.

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

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.

Available from comp-scale-gitAUR[broken link: archived in aur-mirror].


Default Keybindings

Some default Enlightenment keybindings
Shift + F10 Maximize Vertically
Ctrl + Menu Show "Clients" (windows) Menu
Alt + Escape Show "Everything Launcher" (apps, windows, etc)
Win + Left Maximize Left
Win + Right Maximize Right
Alt + Shift + F10 Maximize Horizontally
Alt + Shift + Left Flip to the Desktop on the Left
Alt + Shift + Right Flip to the Desktop on the Right
Ctrl + Alt + D Show the desktop
Ctrl + Alt + F Toggle Fullscreen
Ctrl + Alt + I Toggle iconic mode
Ctrl + Alt + K Kill window
Ctrl + Alt + L Lock the desktop
Ctrl + Alt + N Maximize Window
Ctrl + Alt + R Toggle Shade up
Ctrl + Alt + W Window menu
Ctrl + Alt + X Close a window
Ctrl + Alt + Down Lower
Ctrl + Alt + Up Raise
Ctrl + Alt + Left Flip to desktop on left
Ctrl + Alt + Right Flip to desktop on right
Ctrl + Alt + Delete End session dialog
Ctrl + Alt + Insert Launch the default terminal

Troubleshooting

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

  1. try to see if the same behavior exists with the default theme
  2. disable any 3rd party modules you may have installed
  3. backup ~/.e and remove it (e.g. mv ~/.e ~/.e.back)

If you are sure you found a bug please report it directly upstream.

Compositing

When the configuration needs to be reset and the settings windows can no longer be approached, configuration for the compositor can be reset using the hardcoded keybinding Ctrl + Alt + Shift + Home.

Unreadable fonts

If fonts are too small and your screen is unreadable, be sure the right font packages are installed. ttf-dejavu and ttf-bitstream-vera are valid candidates.

You can set scaling under Settings > Settings Panel > Look > Scaling.

Backlight always dimmed

You may find that Enlightenment routinely dims the backlight to 30% on logout and will only restore it to 100% when you log into another Enlightenment session. This is especially problematic when using another desktop environment alongside Enlightenment as the backlight will not automatically be restored to its normal level when using that desktop environment. To fix this issue, open the Enlightenment Settings Panel and, under the Look tab, click on the Composite option. Tick the Don't fade backlight box and click OK.

Inconsistent cursor theme

You may find that the cursor theme for the desktop is different to the one used in applications such as Firefox. This is because desktop applications are using X cursor themes whilst Enlightenment has its own set of cursor themes. For consistency, you can set Enlightenment to always use the X cursor theme. To do this, open the Enlightenment Settings Panel and click on the Input tab. Click on the Mouse option. Change the theme from Enlightenment to X and click OK. You should now find that the same cursor theme is used everywhere. If the X cursor theme itself is not always consistent, see Cursor themes#XDG specification.

Enlightenment DR16

Enlightenment, Development Release 16 was first released in 2000, and reached version 1.0 in 2009. Originally, the DR16 stood for the 0.16 version of the Enlightenment project. You'll find it as "Enlightenment16" now in the Arch repositories, it is still under development today, regularly updated by its maintainer Kim 'kwo' Woelders. With compositing, shadows and transparencies, E16 kept all of the speed that presided over its foundation by original author Carsten "Rasterman" Haitzler but with up to date refinement.

To install E16

Install enlightenment16.

E16 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 E16 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 e16keyeditAUR[broken link: archived in aur-mirror] package.

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 image copied in the ~/.e16/backgrounds/ folder will get the list of available backgrounds auto-updated. Select desired wallpaper from drop-down menu. Inside the appropriate 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 an Init, a Start and a Stop folder 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. Typical examples involves starting pulseaudio or your favorite network manager applet.

Compositor

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

See also