Ideal Sciences Temp Stick Homebridge Plugin

This is an unofficial plugin to use your Temp Stick sensor with Homebridge.

You will need your API key, provided in your account settings. This plugin relies on the API provided by Temp Stick and is dependent on its uptime to retrieve your latest sensors and readings.

Once loaded, this plugin will display all Temp Stick sensors' ambient temperature and humidity. If you are using a thermocouple probe, it will also display the probe's temperature. This plugin updates the sensor data at roughly the same interval set within your account's Sensor Settings (once every 15 minutes to 24 hours). Temp Stick, nor this plugin, will display live Temp Stick readings as the sensor is only active during its next_checkin.

If you change any settings or names in your Temp Stick account you may have to reload the plugin to see those changes reflected and receive timely results.

Notifications with Ntfy

What you need:

1. Free account at Ntfy (or another Ntfy instance).
2. Ntfy access token found under /account.
3. Unique topic (temperature/humidity alerts are generally not sensitive in nature).

The easiest way to get notifications through Homekit for sensor data is adding an automation. To do so, go to your sensor in Homekit and click Add Automation. For ambient and probe sensors you can add automations for temperature rising above or dropping below a specific temperature or humidity. Once you confirm the temperature of humidity, click Next and at the bottom Convert to Shortcut. Configure your Shortcut to Get the appropriate sensor's Current Temperature or Humidity and make a POST/PUT request to Ntfy to publish a message. Add a Header with Key=Authorization and Text= Bearer [your access token]. If you want your notification to have a title, add another Header with the Key=X-Title and Text=Your notification's title.

An example configuration that publishes a notification with a Title and message:

Development Roadmap:

• [x] Discover all sensors and probes
• [x] Ambient temperature, ambient humidity, and probe temperature
• [x] Handle API errors gracefully
• [x] Use offsets (probe_temp_offset, humidity_offset, temp_offset) for calibrated sensors
  • last_tcTemp, last_humidity, and last_temp include any user-set offset
• [x] Request latest readings based on send_interval and next_checkin
• [ ] Homebridge verified
• [x] Request updated documentation in API for undocumented parameters (last_tcTemp and groups for example)
  • Response: "...you don't need to worry about these values as they don't have a direct impact on the data readings"
• [ ] User config groups of sensors instead of retrieving all sensors