Resources for PaPiRus ePaper eInk display
Python Shell
Latest commit e9a10c7 Dec 19, 2016 @francesco-vannini francesco-vannini committed on GitHub Update
Minor change to reflect options in Pixel raspi-config


Resources for PaPiRus ePaper eInk display

Enabling SPI and I2C interfaces on Raspberry Pi

Before using PaPiRus, do not forget to enable the SPI and the I2C interfaces. You can enable the SPI by typing sudo raspi-config at the command line and then selecting Interfacing options > SPI and then selecting Enable. Without exiting the tool still in Interfacing options > I2C and then selecting Enable.

Setup PaPiRus

# Run this line and PaPiRus will be setup and installed
curl -sSL | sudo bash

Getting Started

# Select your screen size
sudo papirus-set [1.44 | 1.9 | 2.0 | 2.6 | 2.7 ]
sudo papirus-config
# System will now reboot

Manual Installation

Install Python API

# Install dependencies
sudo apt-get install python-imaging

git clone
cd PaPiRus
sudo python install    # Install PaPirRus python library

Install Driver (Option 1)

papirus-setup    # This will auto install the driver

Install Driver (Option 2)

# Install fuse driver
sudo apt-get install libfuse-dev -y

sudo mkdir /tmp/papirus
cd /tmp/papirus
git clone

cd /tmp/papirus/gratis-master/PlatformWithOS
make rpi-epd_fuse
sudo make rpi-install
sudo service epd-fuse start

Python API

The Basic API

from papirus import Papirus

# The epaper screen object
screen = Papirus()

# Write a bitmap to the epaper screen

# Perform a full update to the screen (slower)

# Update only the changed pixels (faster)

# Change screen size
# SCREEN SIZES 1_44INCH | 1_9INCH | 2_0INCH | 2_6INCH | 2_7INCH

The Text API

from papirus import PapirusText

text = PapirusText()

# Write text to the screen
# text.write(text)
text.write("hello world")

# Write text to the screen at selected point
# text.write(text, (x,y))
text.write("hello world", (10, 10) )

The Image API

from papirus import PapirusImage

image = PapirusImage()

# easy write image to screen
# image.write(path)

# write image to the screen with size and position
# image.write(path, width, (x,y))
image.write('/path/to/image', 20, (10, 10) )


Your python script must be running with root previlages update the screen and change sizes. This code will only allow the script to run as root

import os
import sys

user = os.getuid()
if user != 0:
    print "Please run script as root"

Command Line

# Set the screen size you are using
papirus-set [1.44 | 1.9 | 2.0 | 2.6 | 2.7 ]

# Write data to the screen
papirus-write "Some text to write"

# Draw image on the screen
papirus-draw /path/to/image -t [resize | crop]

# Clear the screen


All demos can be seen by running the following commands. Code can be found in the repo for the python bin directory.

# Show clock

# Run game of life

# Show system information

# Push framebuffer to screen

# Demo of using the buttons

# Demo of getting temperature from LM75

# Snakes game