Prepared for publishing

.gitignore

@@ -1,2 +1,4 @@
 .DS_Store
 DisplayBacklight.xcodeproj/project.xcworkspace/xcuserdata
+Icon
+

COPYING

@@ -0,0 +1,25 @@
+Copyright (c) 2017, Thomas Buck
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+ - Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+
+ - Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

DisplayBacklight/AppDelegate.m

@@ -100,6 +100,10 @@ struct LEDStrand strands[] = {
 // If this is defined it will print the FPS every DEBUG_PRINT_FPS seconds
 //#define DEBUG_PRINT_FPS 10
 
+// When grabbing screenshots the resulting picture will not have any color filtering
+// effects applied, as is the case when using software like f.lux that makes the colors
+// warmer at night. So I've added the algorithm to 'warm up' the colors myself. Set
+// the target temperature in Kelvin here, it should be the same as in f.lux.
 // ToDo Change color-temperature depending on time of day to match f.lux adjustments
 #define TARGET_COLOR_TEMPERATURE 2800.0
 

README.md

@@ -0,0 +1,22 @@
+# DisplayBacklight
+
+DisplayBacklight is an Ambilight-clone made with an Arduino controlled by a macOS machine.
+
+## Hardware
+
+The software currently only supports driving RGB-LEDs with the colors from the edge of a screen, so you have to place an RGB LED strip on the outer edges of your computer monitors. Multiple screens are supported using a single LED strip for all of them.
+
+You need an LED strip with individually addressable LEDs like the popular [WS2812 RGB LED strips](https://www.sparkfun.com/products/12025). The data line is connected to pin 2 of the Arduino. The [Adafruit Neo-Pixel library](https://github.com/adafruit/Adafruit_NeoPixel) is used to control the LEDs.
+
+## Protocol
+
+The color data is transmitted using the serial port and the USB-UART converter built into most Arduinos. Communication happens at 115200bps, the LED count is hardcoded in both firmware and host software. First, a magic string, also hardcoded, is sent, followed by 3 bytes containing Red, Green and Blue, for each LED. When the last byte has been received the whole strip is refreshed at once.
+
+## Software
+
+The macOS host software is opening the connection to the serial port, grabbing a screenshot, processing the edges to calculate each LED color and finally sending it to the device.
+
+## License
+
+DisplayBacklight itself is made by Thomas Buck <xythobuz@xythobuz.de> and released under a BSD 2-Clause License. See the accompanying COPYING file.
+

epilepsy.sh

@@ -0,0 +1,80 @@
+#!/bin/bash
+
+# The serialHelper115200 file is my own SerialHelper Utility compiled
+# with 115200 baud. Get it from here:
+# https://github.com/xythobuz/SerialHelper
+
+DATA_FILE=led_data_file
+
+if [ $# -ne 6 ]; then
+    echo "Usage: two times three hex bytes for color"
+    echo "$0 r1 g1 b1 r2 g2 b2"
+    exit
+fi
+
+PORTFILE=`ls /dev/tty.wchusbserial* | head -n 1`
+echo "Using $PORTFILE as serial port..."
+
+echo "WARNING: This is toggling the LEDs very fast between your two colors!"
+echo "The name epilepsy is no joke. Be careful."
+read -p "Press ENTER to continue..."
+
+echo "Opening serial port..."
+serialHelper115200 -rw $PORTFILE >/dev/null 2>/dev/null &
+TERM_PID=$!
+echo "PID is $TERM_PID"
+
+echo "Waiting for Arduino to be ready..."
+sleep 3
+
+echo
+
+for i in `seq 1 20`; do
+
+    echo "Preparing data to send..."
+    echo -n "xythobuzRGBled" > $DATA_FILE
+    for i in {1..156}; do
+        echo -n -e "\x$1\x$2\x$3" >> $DATA_FILE
+    done
+
+    echo "Sending data..."
+    cat $DATA_FILE > $PORTFILE
+
+    echo "Waiting for data to appear..."
+    sleep 0.05
+
+    echo
+
+    echo "Preparing data to send..."
+    echo -n "xythobuzRGBled" > $DATA_FILE
+    for i in {1..156}; do
+        echo -n -e "\x$4\x$5\x$6" >> $DATA_FILE
+    done
+
+    echo "Sending data..."
+    cat $DATA_FILE > $PORTFILE
+
+    echo "Waiting for data to appear..."
+    sleep 0.05
+
+    echo
+done
+
+echo "Preparing data to send..."
+echo -n "xythobuzRGBled" > $DATA_FILE
+for i in {1..156}; do
+    echo -n -e "\x00\x00\x00" >> $DATA_FILE
+done
+
+echo "Sending data..."
+cat $DATA_FILE > $PORTFILE
+
+echo "Waiting for data to appear..."
+sleep 0.1
+
+echo "Closing serial port..."
+kill $TERM_PID
+
+echo "Deleting created data file..."
+rm -rf $DATA_FILE
+