Difference between revisions of "E17"

From ArchWiki
Jump to navigation Jump to search
m (→‎Configuring Entrance: removed note, wrong information)
(Nl6720 changed the content model of the page E17 from "JavaScript" to "wikitext": revert; ???)
Tag: New redirect
 
(177 intermediate revisions by 40 users not shown)
Line 1: Line 1:
[[Category:Desktop environments (English)]]
+
#REDIRECT [[Enlightenment]]
[[Category:HOWTOs (English)]]
 
{{i18n|E17}}
 
 
 
E17 is the Development Release 17 (DR17) of the Enlightenment Desktop Environment.
 
 
 
E17 is currently under heavy development, and is in the pre-alpha stages. Even though it is only young, E17 is still quite stable. Many people use it as a day-to-day Environment.
 
 
 
New versions are available daily via SVN, but snapshots are also taken for easy installation. Below are instructions on how to install a SVN snapshot from the Arch community repositories.
 
 
 
== Installing E17 from the community repository ==
 
 
 
* First, edit your /etc/pacman.conf file and uncomment the community repositories by removing the hash at the start of that line; you should end up with something like the following:
 
 
 
[community]
 
# Add your preferred servers here, they will be used first
 
Include = /etc/pacman.d/mirrorlist
 
 
 
* Next, sync, update, and upgrade using the new community repository:
 
pacman -Syu
 
* Install e17 group:
 
pacman -S e-svn
 
* Install additional e17 modules and applications:
 
pacman -S desktop-file-utils e17-extra-svn
 
*Install additional fonts in order to avoid any trouble at the first start of e17
 
pacman -S artwiz-fonts ttf-ms-fonts
 
* If you need an e17 package which is not (yet) available in the [community] repo, see if it is available in the [http://aur.archlinux.org/ AUR].
 
 
 
You are now ready. You can allow '''~/.xinitrc''' to start ''enlightenment'' for you:
 
 
...
 
# exec gnome-session
 
# exec startkde
 
# exec startxfce4
 
# ...or the Window Manager of your choice
 
exec enlightenment_start
 
 
 
If you want the ''entrance'' login manager (to replace [[KDM]]/[[GDM]]), you can either do this via:
 
 
 
* '''/etc/rc.conf''' - You only get the login manager on startup; it will not be there if you CTRL+ALT+BACKSPACE
 
 
...
 
DAEMONS=(... entranced)
 
...
 
 
 
OR
 
 
 
* '''/etc/inittab''' - The recommended way
 
 
 
...
 
## Only one of the following two lines can be uncommented!
 
# Boot to console                                       
 
#id:3:initdefault:                                       
 
# Boot to X11                                           
 
id:5:initdefault:
 
 
...
 
 
# Example lines for starting a login manager
 
#x:5:respawn:/usr/bin/xdm -nodaemon
 
#x:5:respawn:/usr/sbin/gdm -nodaemon
 
#x:5:respawn:/usr/bin/kdm -nodaemon
 
#x:5:respawn:/usr/bin/slim >& /dev/null
 
#x:5:once:/bin/su johndoe -l -c "/bin/bash --login -c startx >/dev/null 2>&1"
 
x:5:respawn:/usr/sbin/entranced --nodaemon >& /dev/null
 
 
 
Enjoy!
 
 
 
 
 
Note : e17 is still alpha software. At some point in the future things may not work as expected anymore. Although all packages are tested before added to the [community] repo, things may stop working for you. You are therefore encouraged to keep packages for the previous version on your computer, allowing you to downgrade if needed.
 
 
 
If you find some unexpected behavior, there is a few things you can do. First try if the same behavior exists with the default theme. Second remove ~/.e (you may want to make a backup first). If you are sure you found a bug please report it directly upstream. If you are not sure if it is a bug in the software or in the package, report it on the [community] bug tracker.
 
 
 
==== I want my e17 packages updated more often ====
 
You can build your own Arch Linux e17 packages with a small python script called ArchE17. For more information and to download the latest version of the script, see [http://dev.archlinux.org/~ronald/e17.html http://dev.archlinux.org/~ronald/e17.html]
 
 
 
== Installing E17 using easy_e17.sh ==
 
 
 
The reason to use this method over the one mentioned before is mostly based on what you want to do, but I find it easier because the script (along with an extra tool) can give those who want more control over when E17 is updated than the aforementioned python script. It allows you to install components from E17's repository without having to go through and make a new PKGBUILD for it. With this script, when you uninstall this package, everything that was installed with the script is uninstalled. If you want to learn more about this script, see [http://ubuntuforums.org/showthread.php?t=916690 the thread for it on ubuntuforums.org].
 
 
 
To install E17 using this script, [http://aur.archlinux.org/packages.php?ID=22793 download the tarball from AUR], extract it to a new directory, and run makepkg. Then run as root:
 
  pacman -U *.pkg.tar.gz.
 
 
 
It will ask you a few questions and then install. You will need to put this in your .xinitrc in order to start E17:
 
 
 
exec /opt/e17/bin/enlightenment_start
 
 
 
It may be helpful to put /opt/e17/bin in your PATH, as then you won't have to add /opt/e17/bin in front of each program in order to run it. To do that, modify this line in /etc/profile:
 
 
 
PATH="/bin:/usr/bin:/sbin:/usr/sbin"
 
 
 
So that it reads instead:
 
 
 
PATH="/bin:/usr/bin:/sbin:/usr/sbin:/opt/e17/bin"
 
 
 
If you encounter any errors while trying to install E17, first check to make sure it isn't a dependency problem. If it is, install the dependency and continue installing e17 by running this command as root:
 
 
 
easy_e17.sh -i
 
 
 
To install one of the many applications from E17's svn repository, simply remove that program's name from /etc/easy_e17.conf, and then run this command as root (replacing name and name2 by the name of the program(s) you removed from easy_e17.conf):
 
 
 
easy_e17.sh -i --only=''name'',''name2''
 
 
 
To update E17 without using the program mentioned below, run this command as root:
 
 
 
easy_e17.sh -u
 
 
 
=== Update_e17.sh ===
 
Another package, for OzOs's update_e17.sh script, is helpful when used in conjunction with this script, as it can backup and restore your E17 svn tree (in case there is breakage), as well as roll it back to a specific revision (again, in case of breakage) or even let you know when a new revision has come around on E17's svn tree. See [http://cafelinux.org/OzOs/content/how-administer-your-ozos-e17-desktop this page] for more information on this optional component. To install this, use either of the above methods. The AUR page is located [http://aur.archlinux.org/packages.php?ID=23227 here].
 
 
 
=== Configuring Entrance ===
 
If you installed e17 through easy_e17.sh you have to do some further configurations to get entrance working.
 
 
 
To '''set up entrance as your login manager''' proceed as above.
 
The correct path of entranced to be put into {{Filename|/etc/inittab}} is of course
 
x:5:respawn:/opt/e17/sbin/entranced --nodaemon >& /dev/null
 
If you want to start entrance as daemon put [http://repos.archlinux.org/wsvn/community/entrance-svn/trunk/entranced entranced] from {{Package Official|entrance-svn}} into {{Filename|/etc/rc.d/}} and add it to your DAEMONS array in {{Filename|/etc/rc.conf}}.
 
 
 
At first you have to '''allow authentication via PAM'''. Therefore get [http://repos.archlinux.org/wsvn/community/entrance-svn/trunk/entrance.pam entrance.pam] from the {{Package Official|entrance-svn}} package and store it as {{Filename|/etc/pam.d/entrance}}.
 
 
 
The following two paragraphs are '''just background information''', skip them if you're in a hurry.
 
 
 
Now the launching and the user authentication should work correctly. But as you'll notice after authentication entrance will fade out and come right back. The reason is that we didn't tell entrance what to launch after authentication.
 
This is done through the file {{Filename|/etc/X11/Xsession}} (can be set at compile time by ENTRANCE_XSESSION) and the .desktop files in your xsessions directories.
 
The following xsessions directories are scanned by entrance:
 
{{Filename|/opt/e17/etc/xsessions/}} (set at compile time by ENTRANCE_SESSIONS_DIR), {{Filename|$XDG_DATA_HOME/xsessions/}} and all <tt>xsessions</tt> directories in your $XDG_DATA_DIRS.
 
 
 
Entrance allows you to choose between multiple sessions which are can be configured via the .desktop files in the xsessions directories. After entrance authenticated the user correctly it executes this file and passes it a string as command line argument.
 
If you chose ''Default'' as session it is just an empty string or "default" whereas the ''Failsafe'' session passes "failsafe".
 
For any other session it's the ''exec'' line of the .desktop file of your session.
 
 
 
So we have to '''configure your X11 sessions'''.
 
At first create {{Filename|/etc/X11/Xsession}} and make it executable
 
touch /etc/X11/Xsession
 
chmod +x /etc/X11/Xsession  # this is important!
 
 
 
I use a modified version of KDM's Xsession script (got the base version from [http://bugs.gentoo.org/show_bug.cgi?id=301051 gentoo bug tracker]):
 
{{File|name=/etc/X11/Xsession|content=<nowiki>
 
#! /bin/sh
 
# Xsession - run as user
 
 
session=${1:-default}
 
 
# Note that the respective logout scripts are not sourced.
 
case $SHELL in
 
  */bash)
 
    [ -z "$BASH" ] && exec $SHELL $0 "$@"
 
    set +o posix
 
    [ -f /etc/profile ] && . /etc/profile
 
    if [ -f $HOME/.bash_profile ]; then
 
      . $HOME/.bash_profile
 
    elif [ -f $HOME/.bash_login ]; then
 
      . $HOME/.bash_login
 
    elif [ -f $HOME/.profile ]; then
 
      . $HOME/.profile
 
    fi
 
    ;;
 
  */zsh)
 
    [ -z "$ZSH_NAME" ] && exec $SHELL $0 "$@"
 
    emulate -R zsh
 
    [ -d /etc/zsh ] && zdir=/etc/zsh || zdir=/etc
 
    zhome=${ZDOTDIR:-$HOME}
 
    # zshenv is always sourced automatically.
 
    [ -f $zdir/zprofile ] && . $zdir/zprofile
 
    [ -f $zhome/.zprofile ] && . $zhome/.zprofile
 
    [ -f $zdir/zlogin ] && . $zdir/zlogin
 
    [ -f $zhome/.zlogin ] && . $zhome/.zlogin
 
    ;;
 
  */csh|*/tcsh)
 
    # [t]cshrc is always sourced automatically.
 
    # Note that sourcing csh.login after .cshrc is non-standard.
 
    xsess_tmp=`mktemp /tmp/xsess-env-XXXXXX`
 
    $SHELL -c "if (-f /etc/csh.login) source /etc/csh.login; if (-f ~/.login) source ~/.login; /bin/sh -c export -p >! $xsess_tmp"
 
    . $xsess_tmp
 
    rm -f $xsess_tmp
 
    ;;
 
  *) # Plain sh, ksh, and anything we do not know.
 
    [ -f /etc/profile ] && . /etc/profile
 
    [ -f $HOME/.profile ] && . $HOME/.profile
 
    ;;
 
esac
 
 
[ -f /etc/xprofile ] && . /etc/xprofile
 
[ -f $HOME/.xprofile ] && . $HOME/.xprofile
 
 
# run all system xinitrc shell scripts.
 
if [ -d /etc/X11/xinit/xinitrc.d ]; then
 
    for i in /etc/X11/xinit/xinitrc.d/* ; do
 
        if [ -x "$i" ]; then
 
            . "$i"
 
        fi
 
    done
 
fi
 
 
case $session in
 
  "")
 
    exec xmessage -center -buttons OK:0 -default OK "Sorry, $DESKTOP_SESSION is no valid session."
 
    ;;
 
  failsafe)
 
    exec xterm -geometry 80x24-0-0
 
    ;;
 
  custom)
 
    exec $HOME/.xsession
 
    ;;
 
  default)
 
    exec /opt/e17/bin/enlightenment_start
 
    ;;
 
  *)
 
    eval exec "$session"
 
    ;;
 
esac
 
exec xmessage -center -buttons OK:0 -default OK "Sorry, cannot execute $session. Check $DESKTOP_SESSION.desktop."
 
</nowiki>}}
 
 
 
That's it the next reboot should bring entrance up and after authentication the ''Default'' session should bring you into E.
 
 
 
== Installing Themes ==
 
More themes to customize the look of e17 are available from [http://exchange.enlightenment.org/ exchange.enlightenment.org].
 
Make sure you also check out [http://www.e17-stuff.org e17-stuff.org].
 
 
 
You can install the themes (coming in .edj format) from the configuration dialog.
 
 
 
You can also change the theme for the etk toolkit (the one which is used by exhibit). You can start the dialog to change the etk toolkit by starting /usr/bin/etk_prefs
 
 
 
[http://aur.archlinux.org/packages.php?ID=7896 e17-themes] (aur package), can automate the download and install of lots of themes from exchange.enlightenment.org
 
 
 
== Troubleshooting ==
 
* If X complains about X cursors not being available, get the package 'libxcursor'.
 
* If screenlock does not accept your password add the following to /etc/pam.d/enlightenment:
 
auth required pam_unix_auth.so
 
 
 
== External Links ==
 
* [http://exchange.enlightenment.org/ Exchange.enlightenment.org, a new, integrated site that replaces the former get-e.org.  get-e.org closed August, 2008.]
 
* [http://e17-stuff.org/ e17-stuff.org,  Themes, backgrounds, etc. are available here]
 
* [http://trac.enlightenment.org/e/wiki/Entrance, Entrance Article in official E17 wiki]
 

Latest revision as of 20:00, 3 April 2019

Redirect to: