Thermacell Liv project interface

Home Assistant 集成

Home Assistant · Python · ESPHome

Thermacell Liv

Complete Home Assistant integration for Thermacell LIV mosquito repellent systems

Thermacell LIV is an innovative smart mosquito repellent system that creates invisible zones of protection around your outdoor living spaces. Unlike traditional citronella candles or spray repellents, the LIV system uses heat-activated repellent cartridges to disperse an odorless, DEET-free vapor that repels mosquitoes within a 20-foot radius.

Features

3 system functions

Integration Features

Intelligent mosquito protection for your outdoor living spaces.

FUNCTION 01

Device Control

Power devices on/off, adjust repellent intensity, and control multiple LIV units independently or as groups

FUNCTION 02

Status Monitoring

Monitor cartridge levels, battery status, connection status, and operating mode in real-time

FUNCTION 03

Multi-Device Support

Manage multiple Thermacell LIV devices across different outdoor zones from a single interface

Entities

3 entity groups

Available Sensors & Controls

Real-time monitoring of all your Thermacell devices.

Thermacell Devices

  • LIV Patio Shield (portable)
  • LIV Pod (wall-mounted)
  • LIV Mini (compact outdoor)
  • LIV Hub (multi-zone controller)

System Sensors

  • Device power state (on/off)
  • Repellent cartridge remaining (%)
  • Battery level (for portable units)
  • Connection status & signal strength

Controls

  • Power toggle (on/off)
  • Intensity adjustment (low/med/high)
  • Zone activation/deactivation
  • Schedule override & manual modes

Automations

4 recipes

Advanced Home Assistant Automations

Without this integration, systems operate in isolation with only basic scheduled behaviors. Home Assistant integration unlocks sophisticated automation capabilities:

AUTOMATION 01

Presence-Based Activation

Automatically activate outdoor mosquito protection when people are detected in outdoor areas. Integrate with motion sensors, door contacts, or phone presence detection to ensure protection is active only when needed, saving cartridge life and energy.

Example: "When back door opens and motion detected on patio between sunset and midnight, turn on patio Thermacell LIV at medium intensity. Turn off automatically 30 minutes after last motion detected."

AUTOMATION 02

Weather-Aware Protection

Integrate with weather data to intelligently adjust protection based on mosquito activity conditions. Mosquitoes are most active during warm, humid, low-wind conditions. Automatically increase protection intensity during peak mosquito hours and reduce or disable during unfavorable conditions like high wind or cold temperatures.

Example: "When temperature above 60°F, humidity above 50%, wind below 10mph, and outdoor motion detected, activate all outdoor Thermacell devices at high intensity. If wind exceeds 15mph or temperature drops below 55°F, turn off devices (mosquitoes inactive)."

AUTOMATION 03

Smart Event Coordination

Coordinate mosquito protection with outdoor events, entertaining, or activities. Create scenes that activate appropriate zones based on calendar events, manual triggers, or voice commands. Integrate with outdoor lighting, music systems, and other smart home devices for comprehensive outdoor entertainment experiences.

Example: "When 'Backyard BBQ' scene activated, turn on all patio and lawn Thermacell devices, activate outdoor string lights, start patio speakers, and send notification when all zones are active. Pre-activate 15 minutes before calendar event starts."

AUTOMATION 04

Cartridge Management & Alerts

Proactively monitor cartridge levels across all devices and send notifications when replacements are needed. Track usage patterns to predict when cartridges will run out and automatically add replacement cartridges to shopping lists or trigger reorder workflows. Prevent situations where devices run out of repellent during active use.

Example: "Monitor all Thermacell cartridge levels. When any device drops below 20%, send push notification with device location and add 'Thermacell Refills' to shopping list. When below 10%, send urgent notification and flash living room lights. Track monthly usage and predict next replacement date."

Installation

HACS · PyPI · GitHub

Installation & Support

METHOD 01 · HOME ASSISTANT

HACS installation

Install directly from HACS (Home Assistant Community Store). This is the easiest method and provides automatic update notifications.

添加到 Home Assistant

Manual sequence

  1. 01Open Home Assistant and navigate to HACS
  2. 02Search for 'Thermacell' in the Integrations section
  3. 03Click Download and wait for installation to complete
  4. 04Restart Home Assistant and add the integration from Settings → Devices & Services
Repository ↗

METHOD 02 · PYTHON

Python library

For developers building custom integrations or scripts, the underlying Python library is available on PyPI.

pip install pythermacell
在 PyPI 上查看 ↗

REQUIREMENTS

  • Home Assistant 2025.11.0 or newer
  • Active Thermacell account with registered LIV devices
  • Thermacell LIV devices connected to Wi-Fi and configured in Thermacell mobile app

OPEN SOURCE · COMMUNITY MAINTAINED

This integration is an unofficial, open-source project developed by the Home Assistant community. It is not affiliated with or endorsed by Thermacell Repellents, Inc. The integration is actively maintained with regular updates to support new features and devices. Community contributions and feature requests are welcome on GitHub.