Guide for Raspbian - 8BitJosh/JukeBot GitHub Wiki

Raspbian (Raspberry Pi 2 or 3 B)

Some information may not be applicable to other Raspberry Pis.

1: Dependencies

The bot requires other software installed on your Raspberry Pi. Run these commands:

sudo apt-get install git
sudo apt-get update -y
sudo apt-get upgrade -y
sudo apt-get dist-upgrade
sudo apt-get install git vlc-nox -y

1.b: Python

As of Raspbian Strech python 3.5 is available as a package and can be installed as:

sudo apt-get install python3.5

If installing on Raspbian Jessie you will have to build it yourself.

To check that Python installed correctly, use the command python3.5 --version. It should output something like Python 3.5.0.

1.c: Pip

Pip is needed to install the Python dependencies required to run the bot, so lets ensure that pip is installed. Run these commands:

cd ~
wget https://bootstrap.pypa.io/get-pip.py
sudo python3.5 get-pip.py

To check that Pip installed correctly, use the command pip3.5 --version. It should output something like pip 7.1.2 from /usr/local/lib/python3.5/site-packages (python 3.5).

2: Clone

Now that the system dependencies out of the way, run the following commands to install the bot in your home directory and install the Python dependencies required:

cd ~
git clone https://github.com/8BitJosh/JukeBot.git
cd JukeBot
sudo -H pip3.5 install --upgrade -r requirements.txt

3: Start

You can start your bot by running this command:

./JukeBot.sh -f

3.b: Start in background

The script also comes with functionality to run the bot as a background process. Start the bot with:

./JukeBot.sh -b

The bot can then be stopped with:

./JukeBot.sh -e

If you want your bot to run on startup of your Raspberry Pi, read this guide.

⚠️ **GitHub.com Fallback** ⚠️