[OBSOLETE] Keenect V1.2.0, optional separate vo settings for cooling, vent obstruction auto clear

Introducing Keenect, a vent management smartApp for your Keen vents.

Keenect a clean slate design, event driven vent and zone management smartApp.

It is a parent/child application consisting of:
–Keenect, the parent, which responds to changes made to your main HVAC thermostat, distributing these events to
–keenectZone, the child app, which then controls your vents based on local temperature conditions and your selected temperature set points.
–A keenectZone consists of one or more Keen vents and a temperature sensor.

What it can do:

  • Even out temperature variations across your configured zones
  • Disable or enable any zone from other smartApps
  • Allows separate and independent heating and cooling settings for each zone
  • Supports C and F temperature scales automatically
  • Prevent excessive static pressure when too many vents are closed when used with an optional pressure sensor DIY Pressure sensor

What it won’t do:
* Fix a horrifically out of balance HVAC system
* Manage your thermostat and its set points
* Provide any thermostat scheduling

What you need to use it:

  • A smartThings integrated thermostat connected to your HVAC system
  • The selected thermostat must be capable of notifying smartThings of its physical and programmatic state changes within a few seconds.
  • I can’t tell you if your wiz-bang thermostat will work or not, but you can.
    With your thermostats device tile open in ST, go up to the thermostat and make some changes, do the same thing from the thermostats native application if it has one.
    If these changes show up in the device tile in ST within a few seconds (and no cheating by hitting refresh), then your thermostat should work fine.
    If it doesn’t, you will need to change thermostats, or find another device type, or find some way to get your thermostat to report properly.
  • Keen vents, it may work with other vents, I do not know.
  • A temperature sensor in each “zone” where you are placing the vents.
    The temperature sensor in the vent cannot be used for this purpose, if you think it can, and will provide me an algorithm supporting your or someone else’s theory, I’m all ears, and you will be my hero.
  • So you will need a source of temperature in each zone, accuracy isn’t so much of an issue as the sensors ability to report temperature changes.
  • The more granular these changes are the better your temperature control is going to be. A sensor that reports (or is modified to report) 0.1F degree changes works well.

Pop into your ide, click the my smart apps tab, then settings, then perform steps 1 and two below…

After that, click update from repo, then select Keenect and keenectZone, then publish both like you normally would do.
In the mobile app, find and install Keenect from the marketplace, smartApps, My Apps. Do not install keenectZone from the market place, Keenect will manage this application for you.

If your Git integration is broken and the above doesn’t work:
Review the manual process here if required

Source code is here:

On the initial install you will need to select your thermostat, the thermostats temperature sensor and your system type: AC capable, or heat only. Do not confuse this with your current operating mode, this selection just lets Keenect know if your system has AC or not. Keenect automatically detects heating and cooling state changes.
That completes the initial installation.
Close and then re-open the Keenect from My Home, SmartApps.

Select create new zone…
Give your zone a name, select your vent(s), and the temperature sensor you will use, and again do not use the temperature sensor in the vent.
Select the minimum vent opening, this is the minimum that Keenect will close the vent to, 20% is a safe starting point.
Maximum vent opening, start at 100%
Select your desired temperature control type:
Offset from main HVAC set point, provides +/- 5 degrees above or below the currently active thermostat set point.
Fixed, the zone set point is static, and will not follow your thermostat settings around.

That’s it for a basic zone configuration, complete the rest of your zones and you should be good to go.

Zone tuning tips:
Set the zone set points to a level where the vents will not close during an operating cycle.
Run a complete cycle, then review the last results report in the reporting section of Keenect.
The end temperatures represent your system balance base line when compared with your thermostat set point.
Now set your zone set points to the desired value.
Observe the last results report when the cycle is complete.
For zones that did not meet their set point, there is little that can be done using a basic configuration.
More than likely you have one or more zones that exceeded your set point.
Start by reducing the maximum opening in intervals of 10% to try to meet your set point. If that still doesn’t do it, you will need to decrease the minimum vent opening level.
You may find a zone that still ends up beyond your set point, even with the vent closed all the time, Keenect can’t fix that as one can imagine.

Advanced options and features:

  • Force vent opening to, is provided for testing purposes, and will set your vent levels all at once to the specified opening, once done using this, return the selection to “Do not change”
  • IDE logging level, primarily used for debugging should the need arise, the default is Lite, which shows reasonable readable output of what’s happening, a None option is also available.
  • Send Lite level log events to notification feed, Lite log events will appear in the mobile app, notifications, Messages panel (this is where your Routines display their output)
  • Delay zone cycle end notification, delays notifying the zones of the thermostat IDLE state change by the specified amount, should the need arise.
  • Over pressure contact sensor, when used with this DIY Pressure sensor, Keenect will prevent your system against excessive static pressure by having too many vents closed. When a pressure event is detected, all vents are opened fully until pressure is relieved, at which point participating zones will have their openings increased by 5%, should additional pressure events occur during a given cycle, an additional 5% is added until the over pressure is resolved.

* Quick recovery, overrides a zones maximum vent opening, forcing the vent to full open until the zone temperature is within a degree of the zone set point.

  • Close vent options, various options for closing the vents at cycle end, and when disabling the zone from a zone control switch.
  • Zone control switch, an external switch, physical or virtual that allows enabling or disabling a zone. A disabled zone will not respond to thermostat or zone temperate change events.
  • IDE logging, same options as Keenect.
  • Send Lite…, same options as Keenect.
  • Pressure management, allows excluding a zone from the gradual opening increases due to pressure events, this will not exclude a zone from the initial 100% opening that’s used to relieve the initial event.

Several in app reports are available from Keenect, on the Available Reports page
Configuration, a snap shot of the currently configured settings.
Current state, the current state of the main thermostat, and all the zones
Last results, a summary of results from the last completed HVAC cycle.

And now the disclaimer and over pressure rant:

  • I make no claims and take no responsibility over the suitability of this software in providing and supporting the features outlined above.
  • In other words, if you or this app does something bone headed, there’s nothing I’m going to do about.
  • It is a piece of software, written by a person, and while it’s been through about a month of beta testing with 20 some odd users, that alone will not guarantee perfection, or suitability in your use case.
  • I will endeavor to fix bugs as they are reported and within the constraints of my life and full time job.

On the pressure protection subject:

  1. I expect you to have done your research in regards to installing automated vents in your home.
  2. I offer no support in determining the suitability of this application, or the vents themselves with your particular HVAC system.
  3. I will not make any best guesses concerning what the total safe amount of vents to have closed at any one time is, nor the number of vents required to do XYZ.
  4. I have exhausted all my various attempts to use Keens on board pressure and temperature sensors to assist in determining over pressure system states, so please don’t ask about it. Having said that, if you have a demonstrated proven algorithm that could be used in this application using these sensors, and care to share it, you will be my hero…
  5. The pressure protection system that is included in this release requires a DIY pressure sensor, the build page for this is here:DIY Pressure sensor.
  6. If you have concerns currently about what your safe pressure parameters are, I would contact your HVAC folks and have them do a system assessment.

I would like to extend my thanks to all the beta testers that have been a part of enduing some 20+ builds over the past month, but in particular to @SBDOBRESCU and @keltymd who have been there with me from day one, and on a daily basis.
Without these two, this app would not be what it is right now, many thanks guys!


and the vents are on sale for a little bit…


If you have Keen vents you need this app. It has made all the difference in the wold in my house. My rooms would stay 3 or more degrees out of sync and my oldest daughters room would sometimes be 5 or more degrees cold at night with her door closed. Now well a picture is worth a 1000 words they say. all
rooms are set to 69 degrees except Ariels it is set to 71


What app is that. I have been looking for one like that because every cent is keen in my house.

Install @Mike_Maxwell Keenect and the screenshot I gave is just a Smarttiles dashboard.

I can’t get my nest g3 on smartthings not very good with getting the codes to work.

I was running one for a while and swapped over to a CT100.

My recomendation to nest users.

  1. Dont user Pollster to poll use a rule in rule machine that is triggered off of an action (I use a keen vent temp change to trigger in every 60 seconds) have that do your nest polling for you and you will run much better.

  2. use an alternate thermostat temp source that way you can update more often.

  3. Craigslist your nest and get a Zwave Thermostat :slight_smile:

I have also modified the Keep Me Cozy II app so that IO can more accurately control the temp sepoints down to the 1/10 of a degree and have it update much more often.

I love the best cameras and protect but just not really sold on the tstat. It was my first purchase and didn’t look into it much. Now I have everything you could think of and can’t get the tstat to work with anything. They need to teach a class how to copy a code and install it on here. From 5 door locks to my pet.net bowels I have everything connected and wish I could find something that let canary in to ST

That vent deal is pretty good, and tempting. I wonder if they’re unloading inventory in prep for something new? Regardless, I may have to get a couple more.

1 Like

It’s that or they don’t have enough data flowing in to build the ginourmous analytics warehouse they need in order to sort their pressure sensors out…

its a short i got the email on it today for Valentines day. I guess more on the she buys for him front :slight_smile:

1 Like

lmao, now that makes sense! Thanks for all your work on this, and to everyone who helped test.


Awesome - any recommendations/suggestions for temperature sensors? This is the app I’ve been looking for!

I’m using the Iris contact sensors. They seem to be pretty accurate and the code can be easily modified to report more often and to take the temp out several places to the right of the decimal (79.1234).

plus, they are cheap.


I like my HSM200
They work great and never need batteries


This looks awesome, thanks so much!

Just a quick question… I am using the system mainly to close of my basement heating in my home theater when we are not down there. I looks like I should be using the zone control switch to turn off that zone. I would like to use the Ecobee3 motion sensing (occupied/unoccupied ) signal and only enable the zone when occupied. I didn’t see the thermostat motion as an available switch. I can build a virtual switch in rule machine, but wondering if you plan to add?

Also what is the signal for the close vent options, when system goes to idle?


Yup, rule is the tool for the time being. Maybe down the road we’ll add some occupancy stuff depending on demand and interest.
When the zone switch is on, the zone will respond to thermostat calls and set the vents accordingly based on local temps.
When the switch is off, it will not respond to these events.
You also have options if you want the vents closed at end of cycle ect.

Nice, but ouch on the price. As it is, I’ve got 8 vents - and the one room (office) that has two vents has almost no exposed electrical outlets where temp sensing would be acceptable. That’s the issue I had with the Ecovent stuff. In fact, most of the rooms I’ve got vents in have outlets that aren’t in ideal temp sensing locations.

Too bad no one makes a simple “stick-on” z-wave or zigbee virtual thermostat. Keen would be smart to look in that direction.


Mike, I installed the code (after I figured it out, I’m a bit new to some of this stuff) and I’ve got both “Keenect” and “keenectZone” in my Marketplace (but not in my SmartApps under “My Home”) - did I install it right or wrong…? Been a long time since I coded anything (10+ years) so the Github stuff is new to me but I did manage to follow your instructions and get through it.

BTW thanks for an awesome app that’s right up my alley! This is a big part of what I bought ST for.

Just pop on down to lowes, grab a few iris motions, you’ll eventually end up with them in every room anyway…