Installation

Warning

Ensure that the Pre-requisites from the previous section have been performed, checked and tested before proceeding.

Note

The library has been tested against Python 2.7, 3.4 and 3.5.

For Python3 installation, substitute the following in the instructions below.

  • pip ⇒ pip3,
  • python ⇒ python3,
  • python-dev ⇒ python3-dev,
  • python-pip ⇒ python3-pip.

It was originally tested with Raspbian on a rev.2 model B, with a vanilla kernel version 4.1.16+, and has subsequently been tested on Raspberry Pi model A, model B2 and 3B (Debian Jessie) and OrangePi Zero (Armbian Jessie).

From PyPI

Note

This is the preferred installation mechanism.

Install the latest version of the library directly from PyPI:

$ sudo apt-get install python-dev python-pip libfreetype6-dev libjpeg8-dev libsdl1.2-dev
$ sudo pip install --upgrade luma.oled

From source

For Python 2, from the bash prompt, enter:

$ sudo apt-get install python-dev python-pip libfreetype6-dev libjpeg8-dev libsdl1.2-dev
$ sudo python setup.py install