The resources below are also needed to further set up the project.

  • 3D Printing Device
  • 3D Printed Panels
  • Jumper Wires to Connect from the Buttons to the Circuit
  • Soldering Iron Equipment
  • 2.4 GHz Wi-Fi Connection
  • Shell to Set Up the Connection from the APIs to the Raspberry Pi
  • 3M Double-Sided Tape (*NOT REQUIRED but it helps keeping the Pi in place on the panel)
  • Small Metal File (*NOT REQUIRED but used to shave holes on the case to fit other buttons)

Once all the parts have been delivered, you can begin building the project following this installation guide step-by-step.

  1. Begin by printing out the 3D objects by downloading it here.

      NOTE: If the buttons don't fit in the case, use a metal file to shave the button holes at the top of the case.

  2. Using the micro SD card you bought

      i. Download and install Raspbian Buster Lite OS disk image on your PC.
      ii. Flash the disk image from your PC to the SD card.
      iii. Locate the /boot directory that your SD card is mounted as.
      iv. Create a plaintext file called wpa_supplicant.conf and paste the following code.

                      country=US # Your 2-digit country code
                      ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
      v. Replace the country, ssid, and psk variable values with correct values that correspond to your 2.4GHz network.
      vi. Create an empty file named ssh by executing the following code your shell.
                      touch ssh

  3. Insert the SD card into the Pi and boot up the system.

      NOTE: Make sure the .conf file you made disappears from your SD card's /boot directory once your Pi boots up, correctly.

  4. Connect the RGB bonnet on top of the Raspberry Pi.
  5. Solder the button to the bonnet to pin 24 using a jumper wire.
  6. To prevent the LED panle from flickering, solder another, smaller jumper wire from port 4 to port 18 on the bonnet.
  7. Using the gray ribbon you bought, connect one end to the panel's JIN1 port and the other end to the bonnet's JIN1 port.
  8. With the Y-cable included with the LED panel, connect one of the connectors to the battery side of the panel.
  9. On the other end of the Y-cable are two pitchfork connectors

      i. Connect the red wire's pitchfork connecter to the positive terminal shown on the bonnet by using a flathead screwdriver.
      ii. Connect the black wire's pitchfork connecter to the negative terminal shown on the bonnet by using a flathead screwdriver.

  10. Connect the power supply to the bonnet and wait unitl a green light turns on.
  11. Screw the 3D printed panels onto the holes in the LED panel.
  12. Drill 4 holes on the sides of the 3D printed case for the LED board at the locations where the panels have holes standing up.
  13. Screw the LED board onto the case, insert the power supply cord through the rectangular hole on the 3D printed case.
  14. Connect to your Raspberry Pi by using the  ssh pi@raspberrypi  command, the default username is pi and the default password is raspberry.
  15. Now that in your Pi's terminal, run the command below.
                      sudo raspi-config
  16. Navigate to the option titled "Localisation Options" and set the timezone to your local timezone.

      NOTE: You can use the Raspberry Pi Configuration Tool to change the ssh username and password, for more security.

  17. Install the Python, Git and Pip tools with the following command.
                      sudo apt-get git python3 python3-pip
  18. Clone the project repository by pasting this command on the terminal.
                      git clone --recursive
  19. Change into the project directory and install the rpi-rgb-led-matrix located inside.
  20. Install all the necessary Python libraries needed to get the project running by executing the following command.
                      pip install -r requirements.txt
  21. In , add the abbreviations for the teams you want to display on the scoreboard in _FAVS arrays for each sport.

      NOTE: The abbreviations for each team in each sport is located in each of the sport's directory in a file called

  22. Boot up the LED Scoreboard by executing and running the following command.

Video Demonstration