Introduction: RasPi Video to OLED

This little project demonstrates live recording video and displaying on a small OLED screen.

Step 1: Things Used in This Project

Hardware components

Software apps and online services

  • XinaBox LUMA OLED

Step 2: Story

Without soldering, wiring or any specific hardware knowledge, you can easyly click this project together and create a viewfinder for your PIcamera.

I marked this project intermediate rather than easy, simply because installation of the libraries might cause slightly issues depending on your starting point of your Raspbian OS. From a clean installation, such as the one I described here:, the below should work without problems.

Step 3: Install Libraries and Other Software

sudo apt install vim git
sudo apt install python-dev python-pip libfreetype6-dev libjpeg-dev build-essential
sudo -H pip install --upgrade luma.oled
sudo -H pip install picamera
sudo apt install libsdl-dev libportmidi-dev libsdl-ttf2.0-dev libsdl-mixer1.2-dev libsdl-image1.2-dev
sudo -H pip install --upgrade pip setuptools
git clone
cd luma.examples
sudo -H pip install -e .
cd examples

Step 4: Modify the Example

  • Using vim or another editor, edit the file .
  • Find the line cameraResolution = (640, 480) and change it to cameraResolution = (128, 64)
  • Find the line cameraFrameRate = 8 and change it to cameraFrameRate = 4
  • Run the program: python
  • If you cant't stop the program with CTRL+c, try CTRL+\


The final result: Yours truly holding up various amounts of ... fingers!