Requirements and installation

This document describes the PieTime requirements and installation process.

Requirements

PieTime requires the following to work:

  • Python 2.7,
  • PyGame 1.9.1 (also tested with 1.9.2a0),
  • requests 2.4.1 (should work with newer versions).

Installing on Raspbian Jessie

If you’re using Raspbian Jessie on your Raspberry Pi, you can install PieTime using binary packages by following the guide below.

Add PieTime APT repository

Create the file /etc/apt/sources.list.d/pie-time.list and add the following line:

deb https://pie-time.bthlabs.pl/repos/apt/ raspbian-jessie main

Import the repository signing key

$ wget --quiet -O - https://pie-time.bthlabs.pl/keys/apt.asc | sudo apt-key add -

Update the package lists and install PieTime

$ sudo apt-get update
$ sudo apt-get install pie-time

Installing on other systems using PyPI

If you wish to install PieTime on system other than Raspbian Jessie (and potentially on device other than Raspberry Pi), you can do so using the PyPI package by using the guide below.

  1. Install PyGame dependencies,
  2. Run $ sudo pip install pie-time to install PieTime and its dependencies.

NOTE: The second step may require installing additional packages from the system repository, depending on your current setup.

Installing from the source

In order to install PieTime, please follow the guide below. Note that this guide assumes Unix-like OS and root access.

  1. Install PyGame dependencies,
  2. Clone the repository $ git clone https://git.bthlabs.pl/tomekwojcik/pie-time.git,
  3. Enter the PieTime directory: $ cd pie-time,
  4. Install PieTime: $ python setup.py install.

NOTE: The fourth step may require installing additional packages from the system repository, depending on your current setup.

Installing as non-root user

If you wish to install PieTime as non-root user, you can do so by installing it from the PyPI package or source code using a virtual env.

To learn more about Python virtual envs, see the virtual env documentation