These instructions assume you already have a working Raspberry Pi (RPi) installed with a recent version of raspbian with network connectivity (e.g. via a wifi adapter), and that you are somewhat familiar with the linux terminal on your RPi.
Step 0 – Update Raspian
Before you get started update and upgrade raspian to the latest:
sudo apt-get update sudo apt-get upgrade
Step 1 – Download LightShow Pi
Download the latest version of LightShow Pi using one of the following two methods from a terminal window on your RPi:
Download Method 1 – git (preferred)
This is the preferred method of downloading the LightShow Pi software as it will enable you to easily update the software to future releases.
# Install git (if you don't already have it) sudo apt-get install git-core # Clone the repository to /home/pi/lightshowpi cd ~ git clone https://firstname.lastname@example.org/togiles/lightshowpi.git # Grab the stable branch cd lightshowpi git fetch && git checkout stable
Download Method 2 – zip file
If you are unable to use git for whatever reason, you can also download the stable branch of the software as a zip file.
cd ~ wget https://bitbucket.org/togiles/lightshowpi/get/stable.zip unzip stable.zip
This will create a directory with a name similar to togiles-lightshowpi-e577fcd4d6af in your home directory with all of the files needed for installing and using LightShow Pi. Rename this directory to lightshowpi:
mv togiles-lightshowpi-e577fcd4d6af lightshowpi
Note: You’ll need to replace e577fcd4d6af in the above command with the name of the directory that unzipping stable.zip created – it will most likely be different!
Step 2 – Install LightShow Pi
Run the install script to retrieve the various dependencies lightshowPi uses, replace the directory /home/pi/lightshowpi with the directory you downloaded the repository to in step 1 above:
cd /home/pi/lightshowpi sudo ./install.sh
The install process can take awhile (go get a snack, watch some netflix, play a game, then come back) as it installs all the necessary software packages needed to run Lightshow Pi. You should reboot your Raspberry Pi after the install completes:
If you run into any issues, feel free to ask others for help in our Reddit Community
Now that you have the software installed, you can move on to testing your hardware configuration.