Python driver for Embedded Artists E-paper Display Module
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.



Python driver for Embedded Artists 2.7 inch E-paper Display Module:

It's based on original C code available here:

Downloads Number of PyPI downloads


So you got your new shiny E-paper display from Embeded Artists. You plug it to your rPi to display some images. But how? Example C code is not very easy to adapt. All images included in C demo are written as byte tables in C header files. Function for displaying an image takes pointers to int8_t... In order to display new image you need to remember and old one. WTF!?!? You just wanted to display a png or jpg from your disk or web. And preferably do so in python. If that's your story then epyper is just for you.

Epyper provides high level python interface for displaying images on e-paper. The most important class is DisplayController, which provides displayImg method accepting PIL Image to be displayed. The image needs to have proper size. It doesn't necessary needs to be black and white only - color images will be converted but the effect may be dissapointing so it's better to provide b&w or convert it before handing it to the DisplayController.


The best way to install epyper is to use PIP:

pip install epyper

This command will install latest stable version with all dependencies. You can of course clone development version from github but it's not guaranteed to be working.

Another option is use PIP to install latestest version from github, like this:

sudo pip install git+

How to use it?

#necessary imports first
from PIL import Image
from epyper.displayCOGProcess import Display
from epyper.displayController import DisplayController

#create DisplayController instance specifying display type as an argument
display = DisplayController(Display.EPD_TYPE_270)

#open some image
im ="some_image.png")

#display it!