Skip to content

Commit 54c59a1

Browse files
Update README.md
Added descriptions for v2.1 and v2.2 features and enhancements.
1 parent f88557e commit 54c59a1

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

README.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ Harmonize Project *for Philips Hue* [![ForTheBadge built-with-love](http://ForTh
22
============================
33
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)<!--[![Trust](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fastronomer.ullaakut.eu%2Fshields%3Fowner%3DMCPCapital%26name%3DHarmonizeProject)](#)--> [![Open Source Love svg2](https://badges.frapsoft.com/os/v2/open-source.svg?v=103)](https://matthewpilsbury.com)
44

5-
Harmonize Project is a low-latency video analysis and pass-through application built with Python which connects to Philips Hue lights and lightstrips based on their location relative to your TV screen; creating an amazing ambient lighting effect!
5+
Harmonize Project connects Philips Hue lights and lightstrips to your TV screen content, creating an amazing ambient lighting effect! This application utilizes a low-latency video and color analysis built with Python 3.
66

77
Check out our Reddit thread [here](https://www.reddit.com/r/Hue/comments/i1ngqt/release_harmonize_project_sync_hue_lights_with/) and watch the demo below! Electromaker explains how our application works at a high level in his podcast [here!](https://youtu.be/tYnvYYWedVc?t=1790)
88

@@ -11,6 +11,8 @@ Check out our Reddit thread [here](https://www.reddit.com/r/Hue/comments/i1ngqt/
1111
Harmonize Project (formerly known as Harmonize Hue) has no affiliation with Signify or Philips Hue. Hue and Philips Hue are trademarks of Signify.
1212

1313
# New Features
14+
* v2.2: Support for webcam stream input via file/URL
15+
* v2.1: Support for multiple Hue bridges
1416
* v2.0: Support for gradient lightstrips is now available!
1517
* v1.3: Added multicast DNS discovery for detecting bridge
1618
* v1.2: Latency now optimized for a single light source centered behind display (use the -s argument at the command prompt to enable)
@@ -29,16 +31,16 @@ Harmonize Project (formerly known as Harmonize Hue) has no affiliation with Sign
2931
**Minimum Hardware:**
3032

3133
* Hue bridge using firmware version 194808600 or greater
32-
* Raspberry Pi (tested on version 4B) or Linux box running at 1.5GHz+ with at least 4 CPU cores (tested on Ubuntu 22.04 64-bit LTS)
33-
* Video/Camera input device (tested with an USB 3.0 HDMI capture card)
34+
* Raspberry Pi 4B/3B/Zero or Linux box running at 1.5GHz+ with at least 4 CPU cores (tested on Ubuntu 22.04 64-bit LTS). The RPi 4B will exhibit optimal performance at 1080p resolution. Good performance can be achieved on the RPi 3B and Zero with minimal tweaking to lower frame rates (~10 FPS for the Zero) and video resolutions.
35+
* HDMI video capture card or Webcam input device (ex. https://github.com/silvanmelchior/RPi_Cam_Web_Interface)
3436

35-
**Example A Hardware configuration (Tested on Raspberry Pi 4B):**
37+
**Example A Hardware configuration:**
3638
* RPi RAM: 256MB Free Minimum (512MB recommended)
3739
* RPi CPU: 1.5GHz+, 4 Cores strongly recommended due to running three simultaneous threads.
3840
* HDMI Splitter (Must be able to output 4k & 1080/720p simultaneously) [Here is a good one for $25](https://www.amazon.com/gp/product/B07YTWV8PR/ref=ppx_yo_dt_b_search_asin_title?ie=UTF8&psc=1), though it breaks HDR when downscaling output 2. The goal here is one output of 4K and another output of 1080/720p.
3941
* USB3.0 HDMI Capture Card (Capable of capturing 720/1080p; delay should be 50ms or under.) [I got this when it was $45.](https://www.amazon.com/gp/product/B07Z7RNDBZ/ref=ppx_yo_dt_b_search_asin_title?ie=UTF8&psc=1) A similar one should be fine. These are untested: [Panoraxy](https://www.amazon.com/Panoraxy-Capture-1080PFHD-Broadcast-Camcorder/dp/B088PYDJ22/ref=sr_1_21?dchild=1&keywords=hdmi+to+usb+3.0+capture&qid=1596386201&refinements=p_36%3A1253504011%2Cp_85%3A2470955011&rnid=2470954011&rps=1&s=electronics&sr=1-21) | [Aliexpress (This shape/style tends to perform well.)](https://www.aliexpress.com/item/4000834496145.html?spm=a2g0o.productlist.0.0.27a14df5Wc5Qoc&algo_pvid=e745d484-c811-4d2e-aebd-1403e862f148&algo_expid=e745d484-c811-4d2e-aebd-1403e862f148-15&btsid=0ab50f4415963867142714634e7e8e&ws_ab_test=searchweb0_0,searchweb201602_,searchweb201603_)
4042

41-
**Example B Hardware configuration (for A/V receivers with 2 or more HDMI outputs, also tested on Raspberry Pi 4B):**
43+
**Example B Hardware configuration (for A/V receivers with 2 or more HDMI outputs):**
4244
* Raspberry Pi 4B kit running with recommended power supply. This hardware option was tested on the 8GB model running Ubuntu 64-bit OS (see software setup option B below).
4345
* HDMI Splitter (tested on U9 ViewHD Latest 4K 1x2 HDMI Splitter 1 in 2 Out, Model U9-Pluto v1.4)
4446
* USB3.0 HDMI Capture Card (tested on Elgato Cam Link 4k)

0 commit comments

Comments
 (0)