UI Supported Accessory Types

[oznu]

This issue tracks the types of accessories supported by the Homebridge Config UI X accessory control feature which allows you to view and control your Homebridge accessories in a web browser.

Accessory Types not listed here can still be controlled using your iOS apps.

Currently Supported Accessory Types:

These accessory types can be fully controlled via the Homebridge Config UI X interface:

• [x] Switch
• [x] Outlet
• [x] Motion Detector
• [x] Occupancy Sensor
• [x] Contact Sensor
• [x] Temperature Sensor
• [x] Humidity Sensor
• [x] Air Quality Sensor
• [x] Leak Sensor
• [x] Garage Door Opener
• [x] Lock Mechanism
• [x] Speaker
• [x] Security System
• [x] Battery Service
• [x] Valve
• [x] Irrigation System
• [x] Light Sensor

Partially Supported Accessory Types:

These accessory types can controlled via the Homebridge Config UI X interface, but some controls are still not fully implemented:

• [ ] Light Bulb
  • [x] On / Off
  • [x] Brightness
  • [ ] Hue
  • [ ] Saturation
• [ ] Fan
  • [x] On / Off
  • [x] Rotation Speed
  • [ ] Rotation Direction
• [ ] Fan v2
  • [x] On / Off
  • [x] Rotation Speed
  • [ ] Rotation Direction
  • [ ] Swing Mode
• [ ] Air Purifiers
  • [x] On / Off
  • [x] Rotation Speed
  • [ ] Rotation Direction
  • [ ] Swing Mode
• [ ] Thermostat
  • [x] Set Mode - Off / Cool / Heat / Auto
  • [x] Current Heating / Cooling State
  • [x] Set Target Temperature
  • [x] Current Temperature
  • [ ] Set Target Relative Humidity
  • [ ] Current Relative Humidity
  • [ ] Set Cooling Threshold Temperature
  • [ ] Set Heating Threshold Temperature
• [ ] Heater Cooler
  • [x] Set Mode - Off / Cool / Heat / Auto
  • [x] Current Heating / Cooling State
  • [x] Current Temperature
  • [x] Set Cooling Threshold Temperature
  • [x] Set Heating Threshold Temperature
  • [ ] Set Fan Speed
  • [ ] Toggle Oscillate
• [ ] Window Covering
  • [x] Opening / Closing / Stopped
  • [x] Position
  • [ ] Tilt Angle
  • [ ] Obstruction Detected
• [ ] Television
  • [x] On / Off
  • [x] Show Current Input
  • [ ] Select Input
  • [ ] Remote Control
  • [x] Volume Control
  • [x] Mute

Accessory Types Not Yet Implemented:

If it's not listed above, it's not currently supported.

Adding New Accessory Types

Each accessory type is implemented using an Angular Component. If you know Angular + TypeScript then pull requests for new accessory types are more than welcome.

https://github.com/oznu/homebridge-config-ui-x/tree/master/ui/src/app/modules/accessories/types

[henkied]

hello again, is the add room button not working, when i click on it and put a new room nothing happend

[oznu]

@henkied, it's working on all the browsers I test with.

https://github.com/oznu/homebridge-config-ui-x#supported-browsers

The rooms are only for displaying accessories in the Homebridge Config UI X interface, adding a room here will have no effect on iOS. If a room is empty when the page is left or reloaded it will be deleted.

You should be able to drag an accessory into the new room once it's created, do you not get this option at all?

[henkied]

With Safari 11.03 not possible, chrome and firefox great!!

I have made a rooom "test" with chrome! How can ik change this name :)

[oznu]

Hmm you're right 😕. I'll see if I can fix Safari.

Just create a new room and empty out the "test" room. It will be removed when you refresh the page if it's empty.

[henkied]

Thx @oznu

[oznu]

@henkied - That issue with safari is fixed in 3.1.2.

[Itsmmai]

He Oznu, it is really great.. I'm quit happy with this because this is (as far as I know) no other way to do this without an IOS device. Is there a way to rename devices ? Now it is hard to find out what is what ?

[iShift]

• can you support camera?

[Kepete]

Awesome project! I was thinking all the time that it should be possible to control device with non IOS device when running homebridge. I think this is the first plugin doing it. Some key features like blinds and camera support are missing but I don't think I will manage adding them.

This plugi can help me creating a dashboard on wall without an iPad!

[oznu]

@Itsmmai - I'd like to add that ability, it will probably come at the same time as a generic status page for each service type. Think the "Details" page in the Home app that shows all that extra info about a service.

@iShift - Maybe. I have ordered an IP camera which will allow me to try this out. Stay tuned.

@Kepete - I'll see what I can do about blinds, or as HomeKit calls them, "Window Coverings".

[maciboy]

@oznu First of all, thank you so much for this plugin! For sooo long I was angry about Apple not giving access to HomeKit from my Mac, even when using Siri… Now, I can circumvent this :)

Above you stated, that it is possible to change the brightness of bulbs. Could you please explain how to change the percentage? For now the percentage is taken from what I set it to in iOS Home.app. I can only turn on and off, using the predefined percentage…

Thanks!

[oznu]

@maciboy - long-clicking / long-pressing (on mobile) will bring up the additional properties box where you can adjust the brightness.

[maciboy]

Ah, shame on me 😄

[hejsiri]

which parameter in the accessory configuration is responsible for displaying the window with the brightness after slider? I want to set it to not appear in ordinary light bulbs. http://prntscr.com/k6fwrj

[oznu]

@mientki, only light bulbs that expose the optional brightness characteristic will show the slider.

[hejsiri]

I'm talking about the on / off slider. It is not needed for ordinary incandescent bulbs without brightness adjustment. A popup window is also unnecessary. Can a popup window be hidden by a parameter?

[hejsiri]

@onzu, I have sent a file with a Polish translation for you to the e-mail.

[oznu]

@mientki; from 3.8.7 the light bulb popup will no longer display at all if the bulb does have a brightness option.

I've received your polish translation, thank you.

[thesquaremedia]

@oznu I was thinking for cameras that already have a web app an iframe that will load the url May be a quick solution. At least for the camera view accessory some could be control through it.

[splunkme]

@oznu Hello, I was wondering if there is support for gpio-relay to be controlled through this interface? If not is it on the roadmap or could you point me in the right direction to work on this integration? Thanks!

[oznu]

@splunkme - If those GPIOs are exposed as a HomeKit switch or supported sensor (see list above) then it can be controlled using this interface.

@thesquaremedia - interesting idea. I've not had any luck getting any useful information about the cameras from the HomeKit API so far, though I've not dedicated much time to it.

[linus-dev]

Hi, Will contact sensors be supported in the future?

[hejsiri]

would be nice...

[chrisremie]

This is great! If window coverings will be included, it will be fantastic!

[megane999]

What about blynk accessories?

[max-behr]

Can you please add sprinklers?

[thehauntedmattress]

@oznu Can you add support for the iOS 12.2 TV on/off switches and inputs? This would be for plugins such as homebridge-samsung-tizen and homebridge-webos-tv.

[oznu]

Window Covering support is coming in the next release.

Short Press (fully open / close):

Long Press:

[hejsiri]

Very nice :)

[mafyata]

Hi, I updated the plugin now , but I can’t see my Samsung Tv in accessories tab.

[ebaauw]

Is the TV exposed through the homebridge bridge, or did you pair it to HomeKit separately?

[oznu]

The Samsung TV plugin exposes the accessory separately to the rest of the bridge accessories (like cameras). The current endpoints only work with accessories on the main bridge.

https://github.com/tavicu/homebridge-samsung-tizen/wiki/Installation#6-adding-the-tv-to-home-app

The LG TV plugin will work.

That's not to say the Samsung plugin is doing it wrong; it's just a current limitation on the UI end. When multi-instance accessory control support is implemented this will be resolved.

[oznu]

In the upcoming release of 4.6.0 the plugin will support accessory control of multiple homebridge instances, this should also discover the Samsung TV plugin and similarly exposed accessories.

• Accessory Control: Multi-instance support. You can now control accessories from multiple Homebridge instances.
  • All instances you want to control must have the same PIN, be on the same network, and running in insecure mode
  • You can blacklist instances you don't want to control using the plugin settings
  • Due to the changes required to identify accessories across multiple instances your room layout will be reset after upgrading
  • Your other instances are automatically discovered and you do not necessarily need to have the UI plugin installed on each instance
• Accessory Control: Accessory characteristics (on, off, brightness etc) now update immediately when changed in HomeKit (previously there was up to a 3 second delay)

I'm looking for a few people to test this out and confirm everything works as it should. You can install the current beta by running this command:

sudo npm install -g --unsafe-perm homebridge-config-ui-x@next

Users of the beta will be able to upgrade to the official release of 4.6.0 from the UI once it's made available.

To roll back:

sudo npm install -g --unsafe-perm homebridge-config-ui-x@latest

[grzegorz914]

Thanks for Your good work, I tested Accessory Control behavior and all working OK. In other thing one questions, Have You in plan add support for other accessory like in OH2-Complete:

Binary Sensors: Leak Sensor - Homebridge configuration type: leak

{
    "name": "An items name, as shown in Homekit later",
    "type": "leak",
    "item": "Itemname-within-OpenHAB",
    "inverted": "true",
    "batteryItem": "Itemname-within-OpenHAB",
    "batteryItemInverted": "false"
}

Carbon Monoxide Sensor - Homebridge configuration type: co

{
    "name": "An items name, as shown in Homekit later",
    "type": "co",
    "item": "Itemname-within-OpenHAB",
    "inverted": "true",
    "levelItem": "Itemname-within-OpenHAB",
    "batteryItem": "Itemname-within-OpenHAB",
    "batteryItemInverted": "false"
}

Carbon Dioxide Sensor - Homebridge configuration type: co2

{
    "name": "An items name, as shown in Homekit later",
    "type": "co2",
    "item": "Itemname-within-OpenHAB",
    "inverted": "true",
    "levelItem": "Itemname-within-OpenHAB",
    "batteryItem": "Itemname-within-OpenHAB",
    "batteryItemInverted": "false"
}

Smoke Sensor - Homebridge configuration type: smoke

{
    "name": "An items name, as shown in Homekit later",
    "type": "smoke",
    "item": "Itemname-within-OpenHAB",
    "inverted": "true",
    "batteryItem": "Itemname-within-OpenHAB",
    "batteryItemInverted": "false",
}

Filter Maintenance Sensor - Homebridge configuration type: filter

{
    "name": "An items name, as shown in Homekit later",
    "type": "filter",
    "item": "Itemname-within-OpenHAB",
    "inverted": "true",
    "levelItem": "Itemname-within-OpenHAB"
}

Position Based Actors: Door - Homebridge configuration type: door

{
    "name": "An items name, as shown in Homekit later",
    "type": "door", 
    "item": "Itemname-within-OpenHAB",
    "inverted": "false",
    "multiplier": "1",
    "stateItem": "Itemname-within-OpenHAB",
    "stateItemInverted": "false",
    "stateItemMultiplier": "1",
    "manuMode": "false"
}

Window - Homebridge configuration type: window

{
    "name": "An items name, as shown in Homekit later",
    "type": "window", 
    "item": "Itemname-within-OpenHAB",
    "inverted": "false",
    "multiplier": "1",
    "stateItem": "Itemname-within-OpenHAB",
    "stateItemInverted": "false",
    "stateItemMultiplier": "1",
    "manuMode": "false"
}

Security System - Homebridge configuration type: security

{
    "name": "An items name, as shown in Homekit later",
    "type": "security"
    "homeItem": "Itemname-within-OpenHAB",
    "homeItemInverted": "false",
    "awayItem": "Itemname-within-OpenHAB",
    "awayItemInverted": "false",
    "sleepItem": "Itemname-within-OpenHAB",
    "sleepItemInverted": "false",
    "alarmItem": "Itemname-within-OpenHAB",
    "alarmItemInverted": "false"
}

Thanks

[grzegorz914]

@oznu any plan add support for FFmpeg cam plugin?

[mralexgray]

+1 for HeaterCooler support, or a guide how to implement support!

[tooh]

I have a Withings scale connected and get results. The device API reports Air quality OK and the Battery Service as Unsupported. Can I do something to improve this ?

[oznu]

Added security systems. Currently in @test.

[oznu]

Added leak sensors.

Plus new icons for existing sensor types:

[NoniKoli]

Hi could you add support for Valves ? I can control them from the home app however they don’t work in the web UI. Thanks I love this Plugin it would be perfect if it has Valve Support.

[oznu]

Added valves and irrigation systems.

Generic Valve:

Irrigation System / Irrigation Valve:

Setting the default duration is also supported for accessories that implement it.

[oznu]

Light sensors added @NicoFR75: https://github.com/oznu/homebridge-config-ui-x/pull/623

[oznu]

Added support for Fan v2.

[oznu]

Added support for Air Purifiers

[mitch7391]

Hey @oznu I have noticed an issue with the irrigation system accessory. In config-ui-x it always shows as ‘running’, whereas in HomeKit it shows as ‘scheduled’ and appears off (which is correct).

[grzegorz914]

@oznu Any plan to add Door and Smoke Sensor, is not listed on Your list: Door - Homebridge configuration type: door

{
    "name": "An items name, as shown in Homekit later",
    "type": "door", 
    "item": "Itemname",
    "inverted": "false",
    "multiplier": "1",
    "stateItem": "Itemname",
    "stateItemInverted": "false",
    "stateItemMultiplier": "1",
    "manuMode": "false"
}

Smoke Sensor - Homebridge configuration type: smoke

{
    "name": "An items name, as shown in Homekit later",
    "type": "smoke",
    "item": "Itemname",
    "inverted": "true",
    "batteryItem": "Itemname",
    "batteryItemInverted": "false",
}

[oznu]

Added Heater Cooler.

[alfag4]

Hello, would be great to have a tristate Window Covering with the options to open, close and stop opening/closing based on the current state. Thanks

[RCdiy]

Could accessories be auto organized? Instead of all of them going to the default room could they go to rooms based on the plugin, type (fan, switch, weather).

[mitch7391]

Hey @oznu I have noticed an issue with the irrigation system accessory. In config-ui-x it always shows as ‘running’, whereas in HomeKit it shows as ‘scheduled’ and appears off (which is correct).

Hey @oznu, just wanted to bring this one up again :)