https://github.com/bloomkd46/homebridge-xfinityhome
A Repository For Controlling Your Xfinity Home System and Devices
https://github.com/bloomkd46/homebridge-xfinityhome
Last synced: 5 months ago
JSON representation
A Repository For Controlling Your Xfinity Home System and Devices
- Host: GitHub
- URL: https://github.com/bloomkd46/homebridge-xfinityhome
- Owner: bloomkd46
- License: apache-2.0
- Created: 2022-04-09T23:40:27.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-01-24T01:47:56.000Z (almost 2 years ago)
- Last Synced: 2024-04-25T08:42:04.084Z (over 1 year ago)
- Language: TypeScript
- Size: 2.21 MB
- Stars: 8
- Watchers: 2
- Forks: 0
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# homebridge-XfinityHome
Homebridge plugin to integrate Xfinity Home Devices into HomeKit
[](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
[](https://npmcharts.com/compare/homebridge-xfinityhome?log=true&interval=1&minimal=true)
[](https://www.npmjs.com/package/homebridge-xfinityhome)
[](https://github.com/bloomkd46/homebridge-XfinityHome/wiki/Beta-Version)
[](https://github.com/bloomkd46/homebridge-XfinityHome/actions/workflows/build.yml)
[](/LICENSE)
## Plugin Information
- This plugin allows you to view and control your Xfinity Home System within HomeKit. This plugin:
- downloads a device list
- listens for real-time device updates
- Supports Doors, Windows, Motion Sensors, Lights And Panel.
## Features
- [x] 2FA Compatible
- [x] Easy Setup
- [x] Real-Time Device Updates
- [x] Device-By-Device Logs In Custom UI
- [x] Device-By-Device Info In Custom UI
- [x] Smart Logging (ex. `Unknown current state: ` `Please open an issue about this`)
### Device Features
| Device Type | Features: |
| :------------: | :------------------------------------------------------------------------------------------------ |
| Panel | Arm/Disarm Control
Armed/Disarmed Notifications
Critical Notification If In `entryDelay`|
| Contact Sensor | Bypass Control*
Opened/Closed Notifications
Current Temperature**
Tampered Status |
| Motion Sensor | Bypass Control*
Motion Detected Notification
Current Temperature**
Tampered Status |
| Light Switch | On/Off Control
Brightness Control
Current Energy Usage (Amps) |
> \*Using 3rd-Party Apps Such As [Controller For HomeKit](https://controllerforhomekit.com)
> \*\*Updates When Sensor Tripped
> Don't See A Device? Let Me Know By Submitting A [Feature Request](https://github.com/bloomkd46/homebridge-XfinityHome/issues/new/c)
## TODO
- [ ] Add First-Gen Camera Support
- [ ] Add Next-Gen Camera HomeKit Secure Video Support
- [ ] Add Email/Password Option
- [ ] Add Triggered Status To Panel For Fully Triggered Status
### Prerequisites
- To use this plugin, you will need to already have [Homebridge](https://homebridge.io) (at least v1.3.5) or [HOOBS](https://hoobs.org) (at least v4) installed. Refer to the links for more information and installation instructions.
### Setup
- [Installation](https://github.com/bloomkd46/homebridge-XfinityHome/wiki/Installation)
- [Configuration](https://github.com/bloomkd46/homebridge-XfinityHome/wiki/Configuration)
- [Beta Version](https://github.com/bloomkd46/homebridge-XfinityHome/wiki/Beta-Version)
### Help/About
- [Common Errors](https://github.com/bloomkd46/homebridge-XfinityHome/wiki/Common-Errors)
- [Support Request](https://github.com/bloomkd46/homebridge-XfinityHome/issues/new/choose)
- [Changelog](/CHANGELOG.md)
### Disclaimer
- I am in no way affiliated with Xfinity Home and this plugin is a personal project that I maintain in my free time.
- Use this plugin entirely at your own risk - please see license for more information.