leytonblackler / chromolite Goto Github PK

The Chromolite desktop and Android applications are written in the Java based programming language Processing 3. The desktop application controls the LED strips through serial communication with an Arduino microcontroller set up in configuration to operate the Chromolite purpose built program. The desktop application acts as a server, in which the Chromolite Android application can connect to via Wi-Fi for wireless control. The Arduino microcontroller program required to interface with the desktop application is written using the C/C++ based Arduino language. In order for the Chromolite desktop application to interface with the program on the Arduino microcontroller, some initial circuitry set up is required and is detailed in the setup section below.

• 8 unique modes:
  • Static: Sets the LED strips to either one, two or three non-changing colours.
  • Random: Changes the LED strips to a randomly generated colour at short intervals.
  • Wave: Colours of the spectrum move across the LED strip in a wave-like motion.
  • Music: Reacts to an audio input signal, displaying 3 specified colours.
  • Spectrum: All LEDs gradually cycle through the colour spectrum together.
  • Strobe: Turns all LEDs on and off at a very fast rate to the selected colour.
  • Scan: A short bar rapidly moves across the LED strips from one end to other and back.
  • Off: Turns all LEDs off.
• Remote based control through the Android application to the desktop application over Wi-Fi.
• Support for multiple Android devices connected at a single given time.
• Keyboard shortcut control on the desktop application.
• Spectrum based colour selection.
• Ability to save custom default settings to both the desktop computer and Arduino's non-volatile EEPROM memory.
• Clean, modern and simple user interface.
• Cross desktop platform compatibility (Windows, macOS and Linux).

• There are currently no known issues or bugs.

Click here to report a bug.

• Ability to control speed for random, wave, spectrum, strobe modes and scan modes.

Click here to suggest a new feature.

Colore - A C# library that utilises the Razer Chroma SDK to provide control of LEDs on a range of Razer Chroma devices. The library is used in this project in the Windows background service that the desktop applciation communicates with via UDP in order to control the LEDs on Razer Chroma devices. This allows utilisation of this C# based library from within Java.

oscP5 - A library for the Processing programming environment which implements the Open Sound Control (OSC) network protocol developed at the Center for New Music and Audio Technologies, University of California, Berkeley. The library is used in this project for the purpose of network communication between Android and desktop devices.

controlP5 - A library for the Processing programming environment which provides a set of controllers to build a graphical user interface. The library is used in this project for the purpose of creating an editable text field in the desktop application in which the user is able to input a desired network port.

Arduino-OSC - Libraries for the Processing and Arduino programming environments, built upon oscP5, which allows for OSC protocol communciation over the Serial port to the Arduino platform. The library is used in this project for the purpose of communication between the desktop application and the Chromolite compatible Arduino microcontroller.

Ani - A library for the Processing programming environment which provides a platform for creating smooth easing animations. The library is used in this project for the purpose of animating UI transitions and interactions in the Android application.

NeoPixel - A library for the Arduino programming environment which provides the ability to individually interface with each LED in the WS2812B RGB LED strips. The library is used in this project for the purpose of controlling the LED strips connected to the Chromolite compatible Arduino microcontroller.

Copyright © 2016 - 2018 Leyton Blackler

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.