Documentation

Note: This documentation is outdated. Please go to the RemoteLight GitHub repository for up-to-date documentation.

Contents

Installation
- Arduino
- RaspberryPi
RGB Strips or Leds
- Connecting
Installation You need to download the RemoteLightClient.

RemoteLight currently works with Arduino and RaspberryPi.

Arduino

RemoteLight uses the GlediatorProtocol. You can find the Arduino sketch for WS2812b/WS2811 strips here.
Upload this sketch on your Arduino using the Arduino IDE.
Connect your led strip with the Arduino as shown below.

Open the RemoteLightClient and select ‘WS281x Strip (Arduino)’ mode in settings. Don’t forget to open the ComPort.

RaspberryPi

I recommend this tutorial. It explains everything, such as which settings need to be changed, and so on.
Now upload the RemoteLight Server to your RaspberryPi.
Start the server: sudo java -jar RemoteLight-RPi-0.1.0.jar
Stop the server: Type end or push Ctrl + C.

Run Server automatically at startup

Install screen

sudo apt-get install screen

Edit root startup script

sudo nano /etc/rc.local

Add this before exit 0 and edit the path

su - pi -c "screen -dm -S remotelight sudo java -jar /path/to/RemoteLightServer"

Save (Ctrl + O) and close (Ctrl + X)
Reboot

sudo reboot

The Server should have started in a detached screen.
You can open the screen using this command:

screen -r remotelight

To end the server type ‘end’ or press ‘Ctrl + c’.
Use ‘Ctrl + A and D’ to leave the screen.
Open the RemoteLightClient on your PC, which should be on the same network as the RaspberryPi or directly connected to it via a LAN cable. Select ‘WS281x Strip (RPi)’ mode in settings and enter the IP of the RaspberryPi in the upper field of the main gui. Click ‘connect’, the client should connect to the server if everything is right.

RGB strips or leds

Note: I will not develop any new features for RGB strips or leds.
I have not tested the functionality with RGB strips in detail.
RGB strips or leds are only supported for RaspberryPi.
You need to select ‘RGB LED/Strip (RPi)’ mode in settings.

Connecting

RGB Led

Red left: pin 11
Green left: pin 13
Blue left: pin 15
Red right: pin 16
Green right: pin 18
Blue right: pin 22
Ground: any ground pin

RGB Strip

I recommend this tutorial. But you have to use this pins instead:

GPIO17 (pin11): red
GPIO27 (pin13): green
GPIO22 (pin15): blue
Ground: any ground pin

Installation (Pi4J)

Install Pi4J:

curl -sSL https://pi4j.com/install | sudo bash

Upload the RemoteLight Server to your RaspberryPi.
Start the server: sudo java -jar RemoteLight-RPi-0.1.0.jar
Stop the server: Type end or push Ctrl + C.
Run Server automatically at startup
Open the RemoteLightClient, select ‘RGB LED/Strip (RPi)’ mode in settings, enter the IP of the RaspberryPi in the main gui and click connect.