Skip to content

Philips Hue control app for desktop with screen syncing. C++ with Qt Quick GUI.

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE
MIT
license-screen_capture_lite.txt
Notifications You must be signed in to change notification settings

Perry3D/huestacean

 
 

Repository files navigation

Huestacean

Philips Hue screen syncing app for Desktop. Uses Philips' new Entertainment API to sync the user's screen with their lights with very low latency.

Youtube video demonstrating Huestacean's screen sync feature Youtube video demonstrating Huestacean's screen sync feature

Download

Downloadable binaries for Windows and macOS are available on the Releases page; see Installing for more information. It ought to also be possible to build the source for Linux but this has not yet been tested, see Building below.

Safety notice

This software can cause rapid flickering of your Hue lights that may trigger photosensitive epileptic seizures in vulnerable individuals. DO NOT use this if you are or suspect you are affected by photosensitive epilepsy, or are otherwise photosensitive, epileptic, or suffer from seizures generally. Cease use immediately and consult a doctor if you suffer from any seizure symptoms, which may include lightheadedness, altered vision, eye or face twitching, jerking or shaking of arms or legs, disorientation, confusion, or momentary loss of awareness.

General notes

Hue requirements

A Gen2 bridge is a must. Your bridge and lights should also be using the latest firmware. Use the Philips Hue Android or iOS app to update the firmware.

At the moment this software can't create entertainment groups. You need to do this in the Hue app. Philips has a video describing how to do this on the Hue Youtube channel.

Lights

The Lightstrip Plus is by far the best light I've found for this. It has a wide color gamut, and it dims to a super dark state before it turns off completely. My Gen 1 lights are still pretty bright at their dimmest. This can be a problem when syncing the lights in a darkened room.

Positioning lights

For the best experience, I'd suggest using or more lights behind or to the side of the display, in front of you and within the central cone of vision. Rapid changes in lights behind or to your side are likely to be more distracting and annoying than they are actually enjoyable.

Installing

Windows

Only 64-bit Windows is supported. Only Windows 10 has been tested at this point.

Prerequisites

Install

Download the latest from releases. Extract anywhere. Run huestacean.exe

macOS

Download the .app from releases and run it. So far it's only been tested on 10.11.6 on an old Macbook Pro.

Reporting bugs

Use this repository's Issues to report bugs or other problems.


Building

Dependencies

  • Qt 5.10
  • CMake 3.9

Windows

  • Visual Studio 2017. Community Edition is fine.

All platforms

Clone the repository and its submodules

git clone --recursive git://github.com/BradyBrenot/huestacean.git
cd huestacean

If you've already cloned without the submodules, or you've synced before I changed one of their paths, you may need to

git submodule sync
git submodule update --init --recursive

Windows

CMake, command prompt

Run the 'x64 Native Tools Command Prompt for VS 2017'. cd to the repository directory.

Assuming you have Qt5.10 installed in C:\Qt\5.10.0, run:

mkdir build
mkdir build\debug
mkdir build\release
cd build
SET CMAKE_PREFIX_PATH=C:\Qt\5.10.0\msvc2017_64\lib\cmake
cmake .. -G "Visual Studio 15 2017 Win64"
cd debug
msbuild ../Huestacean.vcxproj /property:Configuration=Debug /property:Platform=x64
cd ../release
msbuild ../Huestacean.vcxproj /property:Configuration=Release /property:Platform=x64

Then use windeployqt to copy in the necessary deployment files. e.g.

C:\Qt\Qt5.10.0\5.10.0\msvc2017_64\bin\windeployqt.exe huestacean.exe -qmldir=../../qml

CMake, Visual Studio

Set the CMAKE_PREFIX_PATH environment variable to, e.g., C:\Qt\5.10.0\msvc2017_64\lib\cmake

Open VS 2017. File -> Open -> CMake -> huestacean\CMakeLists.txt

Switch configuration to x64-Debug or x64-Release

CMake -> Build Only -> Huestacean

or set Huestacean as the startup target and start debugging.

NB: You'll need to copy the necessary Qt DLLs over or run windeployqt before the project will run. e.g.

C:\Qt\Qt5.10.0\5.10.0\msvc2017_64\bin\windeployqt.exe huestacean.exe -qmldir=../../qml

Linux, Mac

Set the CMAKE_PREFIX_PATH environment variable to point to your Qt install directory. For Mac, this could look like:

export CMAKE_PREFIX_PATH=~/Qt/5.10.0/clang_64/lib/cmake

cd into the repository directory, then simply build with cmake and make

mkdir build
cd build
cmake ..
make huestacean

Mac deployment

Use macdeployqt to copy in the necessary Frameworks and other files.

~/Qt/5.10.0/clang_64/bin/macdeployqt huestacean.app -qmldir=../qml

External libraries

This project is using:

License

Refer to the LICENSE file for license info.

Third-party licenses

This software makes use of open source software under various licenses. See qml/about.qml for a full listing of licenses both applicable and not, or the various text files included with the source distribution.

This software uses Qt 5, which is licensed under the GNU Lesser General Public License v3.0. The text of the license can be found in lgpl-3.txt. The corresponding source code for Qt can be found on their website, or at https://s3.us-east-2.amazonaws.com/bbrenot-thirdparty-sourcecode/qt-everywhere-src-5.10.0.tar.xz ; the end user can provide their own Qt5 and modifications by replacing the distributed Qt shared library files (Qt* .dll, .so, .dylib, etc.)

About

Philips Hue control app for desktop with screen syncing. C++ with Qt Quick GUI.

Resources

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE
MIT
license-screen_capture_lite.txt

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 77.8%
  • QML 17.4%
  • QMake 2.4%
  • CMake 2.0%
  • Batchfile 0.4%