First make sure you've loaded the latest Raspbian operating system on your Raspberry Pi.  You can find the OS image download here, instructions for burning to an SD card image here, and a convenient guide here that explains how to load an operating system.

Make sure your Raspberry Pi is connected to the internet, either with a wired connection to its ethernet port, or by setting up wireless access to a WiFi network.  Check out the guide on network setup for more details on using wireless and WiFi networks with the Pi.

Once your Raspberry Pi is powered up and connected to a network you can follow the steps below to install the video looper software.

If you're familiar with connecting to the Raspberry Pi over SSH you can use an SSH terminal application to connect and skip down to the install commands section below.  If you aren't familiar with SSH you can use the Adafruit Pi Finder tool to find your Raspberry Pi and open a terminal to run the installation.  I'll show installation steps using the Pi Finder tool below.

Note with the latest versions of Raspbian (Jessie full & lite since ~February 2017) they disable SSH by default! Read below to see how to enable SSH so you can access the Pi with tools like Pi Finder.

Enable SSH (latest Raspbian Jessie)

For Raspbian Jessie & Jessie Lite since ~February 2017 you need to enable SSH before you can log in to the Pi. See the announcement for more details about the change, but to enable SSH you need to add a blank file called ssh (with no extension!) to the /boot partition of the Pi's MicroSD card.  Place the MicroSD card in a card reader and open its drive on your computer (the drive should be called boot).  Create a file and call it ssh (with no file extension), you can use a tool like Notepad or other text editor (just be sure it doesn't add a .txt extension!).  Eject the MicroSD card and the Pi should boot and enable SSH automatically.

Install with Pi Finder

If you are connected via Ethernet you can use the Adafruit Pi Finder to connect to your PI very easily

First download the right Pi Finder release for your operating system and open the archive.  Run the pibootstrap executable and you should see a screen with a Find My Pi! button appear like below:

Make sure your Raspberry Pi is powered up and connected to the network.  Then click Find My Pi! to have the Pi Finder tool search the network for the Raspberry Pi.

Note that the Pi Bootstrap tool might not be able to find your Pi if you're on a complex network like in a work environment.  If Pi Finder can't find your Pi then try connecting to the Pi with SSH and skip to the install commands section.

After searching for a little while a screen like the above should show up when the Raspberry Pi is found.  Notice the IP address, port, username, and password fields are filled in with default values.

If you're using a brand new Raspbian install you should keep the username and password values the same as the default of pi and raspberry.  If you changed your Pi's username or password then put in the correct values to the forms.

Ignore the rest of the fields like hostname, SSID, etc.  We won't need to change any of those to install the video looper.

Now click the Terminal button to open a command terminal on the Raspberry Pi.

After a few moments you should see a terminal open with a message like the above.  At this point you're connected to the Raspberry Pi and ready to run commands to install the video looper.

If for some reason the terminal can't connect, check that your Raspberry Pi is connected to your network and try finding it again with the Pi Finder.

Install Commands

To install the software first type the following command exactly as follows (note there's a small bug in the Pi Finder right now and copy/paste doesn't work, but don't worry the command to type isn't that long):

sudo apt-get update
sudo apt-get install -y git
git clone

After pressing enter to run the command you should see something like the above displayed.  The source code for the video looper has been downloaded to your Raspberry Pi.

Now run these two commands to finish the install:

cd pi_video_looper
sudo ./

You should start to see a lot of messages printed to the screen as software is downloaded and installed.

After about 5 minutes you should see the installation stop with the message Finished! like the picture below shows.  If you see this message then the installation succeeded.

If the installation fails for some reason it will immediately stop and display an error.  Check the terminal for the error to see if it's something you can easily correct like a failure to access the internet, or try asking for more help on the Adafruit forums.

After the software installs you should see the video looper display on the HDMI port.  Assuming no USB drives with movies are connected to your Pi, there should be a message telling you to insert a USB drive like below:

If you see the message above then congratulations the video looper software is installed!  Continue on to learn how to use the video looper.

This guide was first published on Feb 13, 2015. It was last updated on Feb 13, 2015.

This page (Installation) was last updated on Jun 16, 2021.

Text editor powered by tinymce.