Installation - Grayda/bellboy GitHub Wiki

Bellboy runs on Windows, Linux and Mac (untested) but is really designed to run on a Raspberry Pi B+ or 2, coupled with a Adafruit PiTFT 2.2" (non touch) screen and mounted into a custom 3D printed case.

The project includes an install.sh script that is designed to be run over the internet (or locally) to automate much of the install.

Installation instructions are as follows:

  1. Solder the 2.2" touch screen to the RPi (for a more reversible installation, solder the screen to the GPIO extension and clip that to the Pi. Adjust your case accordingly, based on your decision
  2. Flash the latest Raspbian image to a micro-SD card. You can use the Adafruit Easy Image, which is Raspbian coupled with the latest PiTFT-related kernels. You will need to abort installation before install.sh starts installing the support files for the 2.2" screen, as it duplicates much of what the Easy Image does
  3. Boot up the Pi and SSH in. Run this command: sudo wget --no-check-certificate -qO- https://raw.githubusercontent.com/Grayda/bellboy/master/install.sh | bash (remove the --no-check-certificate if necessary. It's included because my organisation uses self-signed certificates
  4. Follow the prompts. If you're using Raspbian, install the Adafruit PiTFT kernels. If you're using the EasyImage, Ctrl+C out of the script and reboot. Be sure to change the password
  5. Bellboy will load at boot. Check this by visiting http://raspberrypi:8080. The default config and bell schedules will load until you make changes that are saved.
  6. Right now the add / edit part of Bellboy is not working. To make changes, copy bells_default.json out of ~/bellboy/core/config/schedules and edit. Use a tool like http://jsonlint.com/ to ensure it's valid. Use sudo service bellboy restart to start it again, or use the reload button in the config page of the web UI