General purpose Display Manager built on the Enlightenment Foundation Libraries (EFL)
Clone or download
Permalink
Failed to load latest commit information.
data data: Remove iCCP chunk from user PNG images, prevents noise during b… Jul 25, 2018
po po: Updated French translations Oct 1, 2017
src build: Simplify conditional, use variables and single executable func… Aug 10, 2018
tests tests: Added check for travis, switched to change env var vs create dirs Jul 12, 2018
utils utils: Replace -Ddebug with --buildtype=debug Oct 25, 2018
.arcconfig entrance: add arcconfig file Jan 8, 2014
.gitignore gitignore: Added /build/ dir if exists Aug 22, 2017
.travis.yml ci: Replace -Ddebug with --buildtype=debug Oct 25, 2018
AUTHORS AUTHORS: Added myself Jul 27, 2017
COPYING entrance: Re welcome to entrance. The code comes from my previous pro… Aug 9, 2012
ChangeLog entrance: Re welcome to entrance. The code comes from my previous pro… Aug 9, 2012
ISSUE_TEMPLATE.md ISSUE_TEMPLATE.md: Promote header for larger font and border beneath … Jun 21, 2018
README README: Rename README -> README.md for github markdown support Jun 14, 2017
README.md README: Add Codacy shield and link Jul 31, 2018
TODO TODO: Removed todo on matching default theme to e's default, done Sep 30, 2017
meson-chmod.sh build: Initial meson build system support Aug 22, 2017
meson.build build: Fix build under meson 0.48.1, replace debug option usage, issue Oct 25, 2018
meson_options.txt build: Fix build under meson 0.48.1, replace debug option usage, issue Oct 25, 2018
sonar-project.properties Increment version to 3.0.0_alpha5 Aug 6, 2018

README.md

entrance - An EFL based display manager

License Build Status Build Status Code Quality Code Quality

This is a fork and current development version. It is ALIVE! IT WORKS! (for me ©)

A screenshot of Entrance

Known Issues

  • Settings UI is broken, hidden for now Issue #6

About

Entrance is a Unix Display/Login Manager written in Enlightenment Foundation Libraries (EFL). Entrance allows a user to choose a X WM/Desktop session to launch upon successful login. Entrance is alive and working again for logging into X sessions and eventually Wayland sessions!

The project has been resurrected from the dead to live on once again...

History

Entrance is a long story. There has been 2 different code bases and projects both using the name entrance.

3rd Generation

This project is the 3rd generation, fork of the 2nd Generation code base. With a lot of fixes, and initial removal of incomplete and/or broken code. Rather than fix as is, looking to replace functionality with new code and different ways of accomplishing similar functionality.

This generation is currently in development, and should be usable. Please open issues for any problems encountered.

2nd Generation

Sometime later another came along, Michael Bouchaud/@eyoz who renamed his project elsa to Entrance. Which is where the current code base came from. It is not known if this ever was completed or worked, but does not function correctly. If it is usable to log in at all.

The broken, incomplete, unmaintained 2nd Genration Entrance resides in Enlightenment's entrance git repository. A branch may be added to this repository for historical purposes.

1st Generation

There was a project long ago that worked, and went MIA. Copies of the sources for some releases are in some distro repositories. A copy has been obtained via a PCLinuxOS src rpm. Ideally would be great to get a copy of the old entrance repo to add to this one for historical purposes. If you have a copy of the old Entrance repository. Please open an issue and provide a link. That would be much appreciated!

Build

Entrance presently uses meson build system, autotools has been dropped.

Build using meson

prefix=/usr/share
meson \
	--prefix "${prefix}" \
	--bindir "${prefix}/bin" \
	--sbindir "${prefix}/sbin" \
	--datadir "${prefix}/share" \
	--sysconfdir "/etc" \
	. build
ninja -C build

On most systems you likely need a pam file. Meson will install this file.

cp data/entrance.pam.d /etc/pam.d/entrance

The systemd service file is presently not installed. It may or may not be usable and/or correct. Please see the section on logind/elogind for further information.

Configuration

Most things can be configured in entrance.conf, /etc/entrance/entrance.conf Various aspects do no work. Please file issues for anything that is not configurable or does not work.

Usage

In order to start entrance you need a system init script or systemd (untested). This may differ based on your operating system. entrance does not provide an init script at this time, and likely will not run if started directly. Entrance should be invoked via init script or systemd service. There is a provided systemd service file for entrance. It is not know if this works or not.

Entrance User

Entrance presently starts as root and then setuid entrance_client under the user nobody. This was done via sudo and then su for a bit before switch to setuid. Entrance also used to run under "entrance"
users but was changed in this past commit . Inherited design from the 2nd generation.

It may be changed such that entrance runs under its own user, and does not setuid or run under root. This will require creation of a user account and adding permissions for the user for video, etc. It may be possible to accomplish this now, starting entrance under a user say "entrance". Via updating the not known to work entrance.conf start_user option;

value "start_user" string: "entrance";

You will likely also need to create a directory for entrance, and ensure proper permissions. Since not running under root, entrance will not be able to correct this, and does have code for such. Expect to see some errors in log file otherwise. Along with non-functional entrance. If started as root, entrance will create directories with proper permissions as needed.

Multiple Displays

Entrance supports multiple displays, with the login form residing on the primary display. In some cases this does not work correctly. If using X, you may need to set the following settings in your monitor sections.

Section "Monitor"
	Identifier	"A"
	Option		"position"	"0 0"
EndSection

Section "Monitor"
	Identifier	"B"
	Option		"LeftOf"	"A"
EndSection

Section "Monitor"
	Identifier	"C"
	Option		"RightOf"	"A"
EndSection

Without such only the background will appear. The login form will not appear along with the rest of the UI, and the cursor will be an X. This
likely due to bugs in entrance code. The work around is the previously mentioned monitors section.

logind/elogind aka systemd

Presently not supported beyond build systems, no code written, just a service file. There are plans to support logind/elogind for Wayland and X. Initial work is currently under way. No code has been committed yet. There is no ETA at this time for completion.