Go to file
Davide Andreoli 7b5cae318a Maintenance release 1.26.1 2023-10-08 05:39:45 +02:00
doc Copyright 2022 2022-02-27 19:07:34 +01:00
efl Maintenance release 1.26.1 2023-10-08 05:39:45 +02:00
examples Say goodbye to the Systray widget 2018-08-22 21:01:20 +02:00
include Copyright 2022 2022-02-27 19:07:34 +01:00
tests Fix tests 2020-04-27 20:02:57 +02:00
.gitignore gitignore++ 2021-11-14 23:25:02 +01:00
.pylintrc setup: Factorize reading files and cmd exec 2021-12-05 12:00:47 +01:00
AUTHORS Python-EFL: updated authors 2014-03-01 22:03:44 +01:00
CODING README: remove not maintained/broken apps 2021-12-06 11:00:13 +01:00
COPYING Python-EFL: fix the mess with the lgpl version. 2013-12-07 17:54:58 +01:00
COPYING.LESSER ops, forgot to add the .LESSER file 2013-12-07 18:06:25 +01:00
ChangeLog Maintenance release 1.26.1 2023-10-08 05:39:45 +02:00
INSTALL Prepare the 1.24 release 2020-04-30 07:46:20 +02:00
MANIFEST.in Convert changes.html in a standard ChangeLog file 2015-01-07 00:31:06 +01:00
Makefile Dropped python 2.6 support 2021-12-05 16:13:22 +01:00
README.md Update README 2021-12-06 14:27:47 +01:00
api_coverage.py Prepeare the 1.23 release 2019-10-06 08:45:57 +02:00
pyproject.toml packaging is required to build the wheel 2022-02-27 19:49:30 +01:00
setup.cfg Simplify setup.py elm extensions, disable builder option in setup.cfg 2013-11-19 21:21:03 +02:00
setup.py Maintenance release 1.26.1 2023-10-08 05:39:45 +02:00


Python bindings for the EFL

EFL, or the Enlightenment Foundation Libraries, is a collection of libraries for handling many common tasks such as data structures, communication, rendering, widgets and more. Read more on the efl web site.

Python-EFL are the python bindings for the whole EFL stack (evas, ecore, edje, emotion, ethumb and elementary). You can use Python-EFL to build a portable GUI application in minutes.

The documentation for Python-EFL is available here.

Install from pypi

The last stable release is always available on pypi, and pip is the raccomanded way to install Python-EFL:

pip install python-efl

The only requirement is to have the EFL already installed on your machine, see here for install instructions for various linux distro or for building EFL from sources.

NOTE: Currently only sources packages are available on pip, this means that the installation will be quite long as it need to compile all the modules, and that you need a C compiler for installation to work (we highly suggest to use clang as your C compiler). For the next release we have plans to also upload binary packages on pypi, so the installation will be blazing fast and will have zero dependencies!

Install from released tarballs

All the stable releases of python-efl can always be found at: https://download.enlightenment.org/rel/bindings/python/

To install download and unpack a tarball and run:

python setup.py build
python setup.py install --user
sudo python setup.py install (for sistem-wide installation)

NOTE: due to strange cython+gcc behaviour we highly suggest to build python-efl using clang. If you experience issues using gcc (like memory exhausted or strange compile errors) just use clang in this way:

CC=clang python setup.py build

Source repository

If you would like to contribute to Python-EFL and make changes to the Python-EFL code you need to build from git. Development take place in the master branch, while we backport bugfixes in the release branches. You will find a branch for each released version, branches are named as python-efl-X.X.

To build from git you also need to have Cython installed.

Main repository


GitHub repository


The GitHub repo has been created to simplify the workflow for people that do not have a git account in the E repo, and thus improving collaboration. Feel free to make pull requests on GitHub.


Documentation for the last stable release can be found here. Additionally you can generate the documentation yourself from the source code using the following command:

  python setup.py build build_doc

The HTML generated documentation will be available in the folder: build/sphinx/html/

Some of the projects using Python-EFL (in random order)

Project Website
EpyMC - Media Center https://github.com/DaveMDS/epymc
Espionage - D-Bus inspector https://phab.enlightenment.org/w/projects/espionage/
Epour - BitTorrent Client https://phab.enlightenment.org/w/projects/epour/
Eluminance - Fast photo browser https://github.com/DaveMDS/eluminance
Egitu - Git User Interface https://github.com/DaveMDS/egitu
Edone - GettingThingsDone https://github.com/DaveMDS/edone
Epack - Archive extractor https://github.com/wfx/epack

... and many more that cannot fit in this short list. If have some code and want it in this list just let us know.

A short history of Python-EFL

Python-EFL was begun in 2007 by work of Gustavo Sverzut Barbieri and others while working for Nokia on the software project Canola Media Player. The language bindings were initially developed for the individual components of EFL, until merged together in 2013.

He was later joined by Ulisses Furquim Freire da Silva, who together formed the company ProFUSION embedded systems where the developement continued and a new software project called Editje was created, which uses the Python bindings for most of its functionality.

Python-EFL gained many more developers, also at this time an independent application project called EpyMC was created by Davide Andreoli.

In the beginning of the year 2011 the developement was practically halted. In 2012 Davide Andreoli picked up the developement and Kai Huuhko (@kuuko) joined him shortly after. Work at this time was focused on finishing the Python bindings for Elementary, the toolkit library.

In 2013 the individual components were merged together and a new documentation system was implemented, enabling easier access for the end-user developers.

Currently (as in 2022) the bindings are still actively maintained and improved by Davide Andreoli, in his effort to bring to python a powerfull and attractive UI toolkit.