{"id":13586672,"url":"https://github.com/rsnodgrass/hass-sensorpush","last_synced_at":"2025-04-07T18:34:25.217Z","repository":{"id":36086051,"uuid":"205416078","full_name":"rsnodgrass/hass-sensorpush","owner":"rsnodgrass","description":"SensorPush integration for Home Assistant","archived":false,"fork":false,"pushed_at":"2024-11-22T21:32:01.000Z","size":294,"stargazers_count":35,"open_issues_count":5,"forks_count":10,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-05T11:55:50.201Z","etag":null,"topics":["hacktoberfest","hacs","homeassistant","iot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rsnodgrass.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-30T16:10:57.000Z","updated_at":"2025-02-15T20:14:54.000Z","dependencies_parsed_at":"2023-01-16T13:04:12.709Z","dependency_job_id":null,"html_url":"https://github.com/rsnodgrass/hass-sensorpush","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsnodgrass%2Fhass-sensorpush","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsnodgrass%2Fhass-sensorpush/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsnodgrass%2Fhass-sensorpush/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsnodgrass%2Fhass-sensorpush/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rsnodgrass","download_url":"https://codeload.github.com/rsnodgrass/hass-sensorpush/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247707755,"owners_count":20982842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","hacs","homeassistant","iot"],"created_at":"2024-08-01T15:05:43.850Z","updated_at":"2025-04-07T18:34:24.720Z","avatar_url":"https://github.com/rsnodgrass.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# SensorPush Integration for Home Assistant\n\n[🥈](https://www.home-assistant.io/docs/quality_scale/)\n![beta_badge](https://img.shields.io/badge/maturity-Beta-yellow.png)\n![release_badge](https://img.shields.io/github/v/release/rsnodgrass/hass-sensorpush.svg)\n![release_date](https://img.shields.io/github/release-date/rsnodgrass/hass-sensorpush.svg)\n[![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg)](https://github.com/hacs/integration)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\nHome Assistant integration for wireless SensorPush temperature and humidity/hygrometer sensors.\n\n## NATIVE HOME ASSISTANT SUPPORT\n\nAs of the Home Assistant 2022.08 release [SensorPush](https://rc.home-assistant.io/integrations/sensorpush) sensors are natively supported WITHOUT require a gateway! \n\n## Hardware Supported\n\n| Model                             | Temp | Humidity | Pressure | Dewpoint | VPD |\n| --------------------------------- |:----:|:--------:|:--------:|:--------:|:---:|\n| [HT.w](https://amzn.to/3kHq02j)   |   X  |     X    |          |     X    |  X  |\n| [HTP.xw](https://amzn.to/2MH4gXx) |   X  |     X    |    X     |     X    |  X  |\n| [HT1](https://amzn.to/3b9GWLB)    |   X  |     X    |          |     X    |  X  |\n\n1. For constant updates of sensor data without opening the iOS or Android app to synchronize data, the [SensorPush G1 WiFi Gateway](https://amzn.to/30b4ycg) is required to continually stream data from the sensors to SensorPush's cloud service However, SensorPush sensors can also synchronize historical data over Bluetooth when nearby an iOS or Android device with the SensorPush app).\n\n2. If you register a new physical sensor with SensorPush, you must restart Home Assistant to discover the new device(s).\n\n## Support\n\nIf you have trouble with installation and configuration, visit the [SensorPush Home Assistant community discussion](https://community.home-assistant.io/t/sensorpush-humidity-and-temperature-sensors/105711).\n\nThis integration was developed to cover use cases for my home integration and released as a contribution to the community. Implementing new features beyond what exists is the responsibility of the community to contribute.\n\n## Installation\n\n### Step 1: Install Custom Components\n\nMake sure you have installed [Home Assistant Community Store (HACS)](https://github.com/custom-components/hacs), then add the \"Integration\" repository: *rsnodgrass/hass-sensorpush*.\n\n#### Versions\n\nThe 'master' branch of this custom component is considered unstable, alpha quality, and not guaranteed to work.\nPlease make sure to use one of the official release branches when installing using HACS, see [what has changed in each version](https://github.com/rsnodgrass/hass-sensorpush/releases).\n\n### Step 2: Enable API Access\n\nIf you've never accessed the [SensorPush Gateway account dashboard](https://beta.sensorpush.com) you must sign in once to agree to Sensorpush terms before this integration can access data in your SensorPush account. (If you've done this any time in the past, you may skip this step.) If you see errors in your log stating `[pysensorpush] Could not authenticate to SensorPush service with \u003cyour_email\u003e and password`, and you've checked to ensure your credentials are correct, you probably need to do this.\n\n### Step 3: Configure SensorPush\n\nExample configuration.yaml entry:\n\n```yaml\nsensorpush:\n  username: your@email.com\n  password: your_password\n\nsensor:\n  - platform: sensorpush\n```\n\n#### Lovelace\n\n![Lovelace Example](https://github.com/rsnodgrass/hass-sensorpush/blob/master/docs/sensorpush-entities.png?raw=true)\n\n```yaml\nentities:\n  - entity: sensor.warehouse_humidity\n  - entity: sensor.warehouse_temperature\nshow_header_toggle: false\ntitle: SensorPush\ntype: entities\n```\n\nLovelace gauge example:\n\n```yaml\nentity: sensor.warehouse_humidity\nmax: 100\nmin: 0\nname: Office\nseverity:\n  green: 45\n  red: 15\n  yellow: 25\ntheme: Backend-selected\ntype: gauge\n```\n\nMore complex example using mini-graph-card and color thresholds:\n\n![Lovelace Example](https://github.com/rsnodgrass/hass-sensorpush/blob/master/docs/sensorpush-graph.png?raw=true)\n\n```yaml\ncards:\n  - color_thresholds:\n      - color: '#00ff00'\n        value: 0\n      - color: '#abf645'\n        value: 30\n      - color: '#FFD500'\n        value: 50\n      - color: '#ff0000'\n        value: 60\n    decimals: 0\n    entities:\n      - entity: sensor.warehouse_humidity\n        name: Humidity\n    font_size: 75\n    hours_to_show: 12\n    line_color: blue\n    line_width: 8\n    points_per_hour: 2\n    show:\n      fill: true\n      icon: false\n    type: 'custom:mini-graph-card'\n  - color_thresholds:\n      - color: '#abf645'\n        value: 0\n    decimals: 0\n    entities:\n      - entity: sensor.warehouse_temperature\n        name: Temperature\n    font_size: 75\n    hours_to_show: 12\n    line_color: var(--accent-color)\n    line_width: 8\n    points_per_hour: 2\n    show:\n      icon: false\n    type: 'custom:mini-graph-card'\ntype: horizontal-stack\n```\n\n#### Tracking Battery\n\nThe battery level of sensors are attributes on each sensor, a separate sensor is not provided. However, if you wish to track battery levels, you can add a template sensor.\n\n```yaml\nsensor:\n  - platform: template\n    sensors:\n      fridge_sensor_battery_voltage:\n        friendly_name: 'Fridge SensorPush battery voltage'\n        unit_of_measurement: 'V'\n        value_template: '{{ state_attr(\"sensor.fridge_humidity\", \"battery_voltage\") }}'\n```\n\n## See Also\n\n* [Community support for Home Assistant SensorPush integration](https://community.home-assistant.io/t/sensorpush-humidity-and-temperature-sensors/105711)\n* [pysensorpush](https://github.com/rsnodgrass/pysensorpush) - Python interface to SensorPush cloud API\n* [SensorPush](https://sensorpush.com) (official product page)\n* [ReviewGeek's review of SensorPush](https://www.reviewgeek.com/3291/sensor-push-review-the-best-smart-hygrometer-and-thermometer-around/)\n\n## Out of Scope\n\nNo plans to implement the following at this time. However, community contributions to add these features would be greatly appreciated!\n\n- [applying calibration adjustments to individual sensors made within the SensorPush app](https://github.com/rsnodgrass/hass-sensorpush/issues/18)\n- poll data directly from sensors via Bluetooth (no cloud dependency required)\n- supporting multiple SensorPush accounts within a single Home Assistance instance\n\n#### Alternative Devices\n\nThe following hardware is not supported. These are just recorded here as these devices share the same internal design; were tested and approved on the same day; but likely require custom firmware flash to be able to communicate with SensorPush.\n\n- [Mitsubishi Kumo Cloud temp/humidity sensor (PAC-USWHS003-TH-1)](https://www.ecomfort.com/Mitsubishi-PAC-USWHS003-TH-1/p81573.html?gclid=CjwKCAiA6vXwBRBKEiwAYE7iSxgq2RjFPeO1yAODQGvRlAAGtobvCq7w2Ay8R7yU9WY4CbK3jVnBxhoCjZ8QAvD_BwE)\n- Oasis OH-31 HT Tracker (FCC Grantee [2AL92](https://fccid.io/2AL92-OH31/Test-Report/Test-Report-3428874), ID: 2AL92-OH31) like the SensorPush (FCC Grantee 2AL9W and [2AL9X HT1](https://fccid.io/2AL9X-HT1/Test-Report/Test-Report-3433404))\n- [iBeTag Beacon IB004NPLUSSHT](https://fccid.io/2AB4P-IB004NPLUSSHT/External-Photos/External-photos-3446863) (FCC Grantee [2AB4P](https://fccid.io/2AB4P))\n- [Jaalee Beacon IB004NPLUSSHT](https://fccid.io/2ABRO-IB004NPLUSSHT/Test-Report/Test-Report-3431944) (FCC Grantee 2ABRO)\n- [Saalee iB004N-Plus-SHT](https://www.dhgate.com/product/wireless-digital-bluetooth-sensor-beacon/451751881.html?skuid=568611302727536642)\n- [AnkhMaway iB004N-Plus-SHT LT](https://ankhmaway.en.alibaba.com/product/60602605562-806002398/Ble_Beacon_With_Temperature_and_Humidity_Sensor_Bluetooth_Programmable_iBeacon.html) / (https://www.beaconzone.co.uk/iB004NPLUSLight)\n- [BLW Eddystone iBeacon](https://www.alibaba.com/product-detail/BLE-Eddystone-iBeacon-Temperature-And-Humidity_60611834273.html?spm=a2700.details.maylikeexp.2.12f71911uMO9SV)\n- [iBeTag AKMW-iB004N-5](https://www.globalsources.com/si/AS/Shenzhen-AnkhMaway/6008840431707/pdtl/Apple-Certified-iBeacon-NRF51822-Low-Energy-Blueto/1100456449.htm)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsnodgrass%2Fhass-sensorpush","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frsnodgrass%2Fhass-sensorpush","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsnodgrass%2Fhass-sensorpush/lists"}