Go to file
Kai Huuhko 6669595f1a Revert python code install location to libdir/enlightenment/gadgets
As requested by DaveMDS
2015-04-08 22:06:14 +03:00
GADGETS Revert python code install location to libdir/enlightenment/gadgets 2015-04-08 22:06:14 +03:00
GADGETS_OLD Say welcome to Edgar, the python gadget loader. 2014-08-27 21:40:56 +02:00
m4 Use a more recent version of the python m4 macro 2014-08-28 23:35:26 +02:00
python Revert python code install location to libdir/enlightenment/gadgets 2015-04-08 22:06:14 +03:00
src Revert python code install location to libdir/enlightenment/gadgets 2015-04-08 22:06:14 +03:00
.gitignore gitignore ++ 2014-08-27 21:44:46 +02:00
AUTHORS Say welcome to Edgar, the python gadget loader. 2014-08-27 21:40:56 +02:00
COPYING Say welcome to Edgar, the python gadget loader. 2014-08-27 21:40:56 +02:00
COPYING.LESSER Say welcome to Edgar, the python gadget loader. 2014-08-27 21:40:56 +02:00
ChangeLog Say welcome to Edgar, the python gadget loader. 2014-08-27 21:40:56 +02:00
INSTALL Say welcome to Edgar, the python gadget loader. 2014-08-27 21:40:56 +02:00
Makefile.am Say welcome to Edgar, the python gadget loader. 2014-08-27 21:40:56 +02:00
NEWS Say welcome to Edgar, the python gadget loader. 2014-08-27 21:40:56 +02:00
README Some doc to help writing your own gadget 2014-08-30 12:11:30 +02:00
autogen.sh Say welcome to Edgar, the python gadget loader. 2014-08-27 21:40:56 +02:00
configure.ac Add back full E19/E20 compatibility 2015-04-07 23:27:08 +03:00
e-module-edgar.edc Say welcome to Edgar, the python gadget loader. 2014-08-27 21:40:56 +02:00
module.desktop.in Say welcome to Edgar, the python gadget loader. 2014-08-27 21:40:56 +02:00
module_icon.png Say welcome to Edgar, the python gadget loader. 2014-08-27 21:40:56 +02:00

README

Edgar Gadget Loader

This module load python gadgets in Enlightenment.


Requirements
============

* Enlightenment >= 0.17
* Python >= 3.2 (also the -dev package if your disto need them)
* Python-EFL >= 1.11 (built for python3)
* python3-dbus


Install
=======

To install the edgar module use the standard:

  ./autogen.sh
  make
  (sudo) make install

If py3 is not the default on your system you need to specify the version:

  PYTHON_VERSION=3.x ./autogen.sh


Gadgets are in the GADGETS/ folder, to install them just use:

  (sudo) make install


The Audio gadget
================

The gadget provide PulseAudio + mpris2 integration.

It dbus to speak with PulseAudio, thus you need to enable dbus in pulse,
in the /etc/pulse/default.pa you need to have the line:

  load-module module-dbus-protocol

Usage tips:
  * the main speaker act on the pulse fallback channel, you can change that
    using the pavucontrol application.
  * mouse-wheel on the speaker to change volume.
  * middle-click on the speaker or any slider to toggle mute.


The led-clock gadget
====================

Usage tips:
  * click on the first led column to trigger fancy animations.


How to write your own gadget
============================

I suggest to start from the ruler gadget, just copy it's folder and
start hacking, a minimal gadget require:

base_folder/   (need to have the same name as the gadget)
  Makefile     (the provided makefile should work for you)
  __init__.py  (the gadget python script)
  gadget.edc   (the gadget edje file)
  images/
    ...
  fonts/
    ...

Look at the e.py file (in the python/ folder in sources) for more
documentation.