_images/logo-text.svg

ESPHome is a system to control your microcontrollers by simple yet powerful configuration files and control them remotely through Home Automation systems.

_images/hero.png

Platforms

ESP8266

ESP32

RP2040

ESP8266

ESP32

RP2040

BK72xx

RTL87xx

BK72xx

RTL87xx

Core Components

Core

PSRAM

WiFi

Core

PSRAM

WiFi

Network

I²C Bus

SPI Bus

Network

I²C Bus

SPI Bus

UART Bus

CAN Bus

MQTT

UART Bus

CAN Bus

MQTT

OTA Updates

Logger

Web Server

OTA Updates

Logger

Web Server

Native API

Power Supply

Deep Sleep

Native API

Power Supply

Deep Sleep

External Components

External Components

Sensor Components

Sensors are split into categories. If a sensor fits into more than one category, it will be listed multiple times.

Core

Sensor Core

Home Assistant

MQTT Subscribe

Sensor Core

Home Assistant

MQTT Subscribe

Uptime Sensor

WiFi Signal Strength

Template Sensor

Uptime Sensor

WiFi Signal Strength

Template Sensor

Custom Sensor

Custom Sensor

Air Quality

AirThings BLE

CCS811

EE895

AirThings BLE

CCS811

CO2 & Volatile organics

EE895

CO2 & Temperature & Pressure

ENS160

GCJA5

HM3301

ENS160

CO2 & Air Quality

GCJA5

Particulate

HM3301

Particulate

MH-Z19

MiCS-4514

PM1006 Sensor

MH-Z19

CO2 & Temperature

MiCS-4514

Gas concentration

PM1006 Sensor

Particulate

PMSA003I

PMSX003

RadonEye BLE

PMSA003I

Particulate

PMSX003

Particulate

RadonEye BLE

Radon

SDS011 Sensor

SEN0321

SEN5x

SDS011 Sensor

Particulate

SEN0321

Ozone

SEN5x

SenseAir

SCD30

SCD4X

SenseAir

CO2

SCD30

CO2 & Temperature & Humidity

SCD4X

CO2 & Temperature & Humidity

SFA30

SGP30

SGP4x

SFA30

Formaldehyde

SGP30

CO2 & Volatile organics

SGP4x

Volatile organics and NOx

SM300D2

SPS30

T6613/15

SM300D2

Air quality

SPS30

Particulate

T6613/15

CO2

ZyAura

iAQ-Core

ZyAura

CO2 & Temperature & Humidity

iAQ-Core

CO2 & Volatile organics

Analogue

ADC

ADC128S102

ADS1115

ADC

ADC128S102

8-channel ADC

ADS1115

4-channel ADC

CD74HC4067

MCP3008

MCP3204 / MCP3208

CD74HC4067

16-channel analog multiplexer

MCP3008

8-channel ADC

MCP3204 / MCP3208

4-channel ADC

Resistance

Resistance

Bluetooth Low Energy (BLE)

AM43

BLE Client Sensor

BLE RSSI

AM43

Lux & Battery level

BLE Client Sensor

BLE RSSI

Inkbird IBS-TH1 Mini

Mopeka Pro Check LP

Mopeka Standard Check LP

Inkbird IBS-TH1 Mini

Temperature & Humidity

Mopeka Pro Check LP

tank level

Mopeka Standard Check LP

tank level

RuuviTag

Xiaomi BLE

Alpha3

RuuviTag

Temperature & Humidity & Accelerometer

Xiaomi BLE

Various

Alpha3

Digital Signals

Duty Cycle

Pulse Counter

Pulse Meter

Duty Cycle

Pulse Counter

Pulse Meter

Pulse Width

Pulse Width

Distance

A01NYUB

A02YYUW

HRXL MaxSonar WR

A01NYUB

Acoustic distance

A02YYUW

Acoustic distance

HRXL MaxSonar WR

Acoustic distance

TOF10120

Ultrasonic Sensor

VL53L0x

TOF10120

IR optical distance

Ultrasonic Sensor

Acoustic distance

VL53L0x

IR optical distance

Zio Ultrasonic Sensor

Zio Ultrasonic Sensor

Acoustic distance

Electricity

ADE7953

ATM90E26

ATM90E32

ADE7953

Power

ATM90E26

Voltage & Current & Power

ATM90E32

Voltage & Current & Power

BL0939

BL0940

BL0942

BL0939

Voltage & Current & Power & Energy

BL0940

Voltage & Current & Power

BL0942

Voltage & Current & Power

CS5460A

CSE7761

CSE7766

CS5460A

Voltage & Current & Power

CSE7761

Voltage & Current & Power

CSE7766

Voltage & Current & Power

CT Clamp

Daly BMS

DSMR

CT Clamp

AC current

Daly BMS

Voltage & Current & Power

DSMR

Electrical counter

HLW8012

INA219

INA226

HLW8012

Voltage & Current & Power

INA219

DC Current

INA226

DC Current & Power

INA260

INA3221

MAX9611

INA260

DC Current & Power

INA3221

3-Ch DC current

MAX9611

+60VDC Voltage & Current & Power & Temperature

PZEM AC

PZEM DC

PZEM004T

PZEM AC

Voltage & Current & Power

PZEM DC

Voltage & Current & Power

PZEM004T

Voltage & Current & Power

SDM Meter

Selec Meter

Teleinfo

SDM Meter

Modbus energy monitor

Selec Meter

Modbus energy monitor

Teleinfo

Electrical counter

Total Daily Energy

Total Daily Energy

Environmental

Absolute Humidity

AHT10 / AHT20 / AHT21 / DHT20

AirThings BLE

Absolute Humidity

AHT10 / AHT20 / AHT21 / DHT20

Temperature & Humidity

AirThings BLE

Temperature & Humidity & Pressure

AM2320

BME280

BME680

AM2320

Temperature & Humidity

BME280

Temperature & Humidity & Pressure

BME680

Temperature & Humidity & Pressure & Gas

BME680 via BSEC

BMP085

BMP280

BME680 via BSEC

Temperature & Humidity & Pressure & Gas

BMP085

Temperature & Pressure

BMP280

Temperature & Pressure

BMP388 and BMP390

BMP581

b-parasite

BMP388 and BMP390

Temperature & Pressure

BMP581

Temperature & Pressure

b-parasite

Moisture & Temperature & Humidity & Light

Dallas DS18B20

DHT

DHT12

Dallas DS18B20

Temperature

DHT

Temperature & Humidity

DHT12

Temperature & Humidity

DPS310

EMC2101

ENS160

DPS310

Temperature & Pressure

EMC2101

Temperature

ENS160

CO2 & Air Quality

ENS210

HDC1080

HTE501

ENS210

Temperature & Humidity

HDC1080

Temperature & Humidity

HTE501

Temperature & Humidity

Honeywell ABP

Honeywell ABP2 I2C

Honeywell HIH I2C

Honeywell ABP

Pressure & Temperature

Honeywell ABP2 I2C

Pressure & Temperature

Honeywell HIH I2C

Temperature & Humidity

HTU21D / Si7021 / SHT21

Hydreon Rain Sensor

Inkbird IBS-TH1 Mini

HTU21D / Si7021 / SHT21

Temperature & Humidity

Hydreon Rain Sensor

Rain

Inkbird IBS-TH1 Mini

Temperature & Humidity

Internal Temperature

MCP9808

MH-Z19

Internal Temperature

MCP9808

Temperature

MH-Z19

CO2 & Temperature

MLX90614

MPL3115A2

MS5611

MLX90614

Temperature

MPL3115A2

Temperature & Pressure

MS5611

Pressure

NTC Thermistor

PMWCS3

QMP6988

NTC Thermistor

Temperature

PMWCS3

Soil moisture & Temperature

QMP6988

Temperature & Pressure

RadonEye BLE

RuuviTag

SCD30

RadonEye BLE

Radon

RuuviTag

Temperature & Humidity & Accelerometer

SCD30

CO2 & Temperature & Humidity

SCD4X

SDP3x / SDP800 Series

SFA30

SCD4X

CO2 & Temperature & Humidity

SDP3x / SDP800 Series

Pressure

SFA30

Formaldehyde

SHT3X-D

SHT4X

SHTCx

SHT3X-D

Temperature & Humidity

SHT4X

Temperature & Humidity

SHTCx

Temperature & Humidity

SMT100

STS3X

TEE501

SMT100

Moisture & Temperature

STS3X

Temperature

TEE501

Temperature

TMP102

TMP117

TMP1075

TMP102

Temperature

TMP117

Temperature

TMP1075

Temperature

HYT271

XGZP68xx Series

HYT271

Temperature & Humidity

XGZP68xx Series

Differential Pressure

Light

AM43

APDS9960

AS7341

AM43

Lux

APDS9960

Colour & Gesture

AS7341

Spectral Color Sensor

BH1750

LTR390

MAX44009

BH1750

Lux

LTR390

Lux & UV

MAX44009

Lux

TCS34725

TSL2561

TSL2591

TCS34725

Lux & RGB colour

TSL2561

Lux

TSL2591

Lux

VEML3235

VEML3235

Lux

Magnetic

ESP32 Hall Sensor

AS5600

HMC5883L

ESP32 Hall Sensor

AS5600

12-Bit Magnetic Position Sensor

HMC5883L

3-Axis magnetometer

MMC5603

MMC5983

MLX90393

MMC5603

3-Axis magnetometer

MMC5983

3-Axis magnetometer

MLX90393

3-Axis magnetometer

QMC5883L

QMC5883L

3-Axis magnetometer

Miscellaneous

AS3935

Binary Sensor Map

b-parasite

AS3935

Storm lightning

Binary Sensor Map

Map binary to value

b-parasite

Moisture & Temperature & Humidity & Light

Combination

Duty Time

EZO sensor circuits

Combination

Duty Time

EZO sensor circuits

(pH)

FS3000

Havells Solar

Integration

FS3000

Air velocity

Havells Solar

Solar rooftop

Integration

Growatt Solar

Modbus Sensor

Nextion

Growatt Solar

Solar rooftop

Modbus Sensor

Nextion

Sensors from display

Rotary Encoder

SMT100

Tuya Sensor

Rotary Encoder

SMT100

Moisture & Temperature

Tuya Sensor

TX20

uFire EC sensor

uFire ISE sensor

TX20

Wind speed & Wind direction

uFire EC sensor

EC & Temperature

uFire ISE sensor

pH & Temperature

Resol VBus

Person Sensor (SEN21231)

Kuntze pool sensor

Resol VBus

Person Sensor (SEN21231)

Kuntze pool sensor

WireGuard

MicroNova pellet stove

WireGuard

MicroNova pellet stove

Motion

APDS9960

BMI160

LD2410

APDS9960

Colour & Gesture

BMI160

Accelerometer & Gyroscope

LD2410

Motion & Presence

LD2420

MPU6050

MPU6886

LD2420

Motion & Presence

MPU6050

Accelerometer & Gyroscope

MPU6886

Accelerometer & Gyroscope

RuuviTag

RuuviTag

Temperature & Humidity & Accelerometer

Thermocouple

KMeterISO

MAX31855

MAX31856

KMeterISO

MAX31855

K-Type

MAX31856

All types

MAX31865

MAX6675

MCP9600

MAX31865

Platinum RTD

MAX6675

MCP9600

All types

Weight

HX711

Xiaomi Miscale

HX711

Load cell amplifier

Xiaomi Miscale

Looking for a sensor that outputs its values as an analog voltage? Have a look at the ADC Sensor together with a formula like in the TEMT6000 configuration.

Binary Sensor Components

Binary Sensors are split into categories. If a sensor fits into more than one category, it will be listed multiple times.

Core

Binary Sensor Core

Custom Binary Sensor

GPIO

Binary Sensor Core

Custom Binary Sensor

GPIO

Home Assistant

Status

Template Binary Sensor

Home Assistant

Status

Template Binary Sensor

Capacitive Touch

CAP1188 Capacitive Touch Sensor

ESP32 Touch Pad

MPR121  Capacitive Touch Sensor

CAP1188 Capacitive Touch Sensor

ESP32 Touch Pad

MPR121 Capacitive Touch Sensor

TTP229

TTP229

Mechanical

Matrix Keypad

TM1637

TM1638

Matrix Keypad

TM1637

TM1638

NFC/RFID Components

Often known as “tag” or “card” readers within the community.

NFC Tag

PN532

PN7150

NFC Tag

PN532

PN7150

PN716X

RC522

RDM6300

PN716X

RC522

RDM6300

Touchscreen

Nextion Binary Sensor

Touchscreen

TT21100

Nextion Binary Sensor

Touchscreen

TT21100

FT5X06

GT911

FT5X06

GT911

Presence Detection

DFRobot mmWave Radar

LD2410

LD2420

DFRobot mmWave Radar

LD2410

LD2420

Miscellaneous

Analog Threshold

ESP32 BLE Presence

Hydreon Rain Sensor Binary Sensor

Analog Threshold

ESP32 BLE Presence

Hydreon Rain Sensor Binary Sensor

Modbus Binary Sensor

PipSolar - compatible PV Inverter

Pylontech Batteries

Modbus Binary Sensor

PipSolar - compatible PV Inverter

Pylontech Batteries

Qwiic PIR Motion

Remote Receiver

Resol VBus

Qwiic PIR Motion

Remote Receiver

Resol VBus

Tuya Binary Sensor

WireGuard

Tuya Binary Sensor

WireGuard

Output Components

Output Core

ESP8266 Software PWM

Slow PWM

Output Core

ESP8266 Software PWM

Slow PWM

GPIO Output

ESP32 DAC

ESP32 LEDC

GPIO Output

ESP32 DAC

ESP32 LEDC

LibreTiny PWM

AC Dimmer

PCA9685

LibreTiny PWM

AC Dimmer

PCA9685

TLC59208F

TLC5947

MY9231/MY9291

TLC59208F

TLC5947

MY9231/MY9291

SM16716

SM2135

SM2235

SM16716

SM2135

SM2235

SM2335

MCP4725

MCP4728

SM2335

MCP4725

MCP4728

MCP47A1

DAC7678

BLE Binary Output

MCP47A1

DAC7678

BLE Binary Output

Modbus Output

Custom Output

Sigma-Delta Output

Modbus Output

Custom Output

Sigma-Delta Output

Template Output

BP1658CJ

BP5758D

Template Output

BP1658CJ

BP5758D

X9C Potentiometer

GP8403

EMC2101

X9C Potentiometer

GP8403

EMC2101

Light Components

Light Core

Binary Light

Status Led

Light Core

Binary Light

Status Led

Monochromatic Light

Cold+Warm White Light

Color Temperature Light

Monochromatic Light

Cold+Warm White Light

Color Temperature Light

RGB Light

RGBW Light

RGBWW Light

RGB Light

RGBW Light

RGBWW Light

RGBCT Light

ESP32 RMT

RP2040 PIO

RGBCT Light

ESP32 RMT

RP2040 PIO

FastLED Light

NeoPixelBus Light

Light Partition

FastLED Light

NeoPixelBus Light

Light Partition

SPI LED Strips

Tuya Dimmer

Shelly Dimmer

SPI LED Strips

Tuya Dimmer

Shelly Dimmer

Custom Light

LightWaveRF

H-bridge Light

Custom Light

LightWaveRF

H-bridge Light

Sonoff D1 Dimmer

Sonoff D1 Dimmer

Looking for WS2811 and similar individually addressable lights? Have a look at the FastLED Light.

Switch Components

Switch Core

GPIO Switch

Restart Switch

Switch Core

GPIO Switch

Restart Switch

Safe Mode Switch

Shutdown Switch

Factory Reset Switch

Safe Mode Switch

Shutdown Switch

Factory Reset Switch

Generic Output Switch

Template Switch

UART Switch

Generic Output Switch

Template Switch

UART Switch

Custom Switch

Tuya Switch

Modbus Switch

Custom Switch

Tuya Switch

Modbus Switch

BLE Client Switch

Nextion Switch

BLE Client Switch

Nextion Switch

Button Components

Button Core

Template Button

Generic Output Button

Button Core

Template Button

Generic Output Button

Restart Button

Safe Mode Button

Shutdown Button

Restart Button

Safe Mode Button

Shutdown Button

Factory Reset Button

Wake-on-LAN

UART Button

Factory Reset Button

Wake-on-LAN

UART Button

Fan Components

Fan Core

Binary Fan

H-bridge Fan

Fan Core

Binary Fan

H-bridge Fan

Speed Fan

Tuya Fan

Speed Fan

Tuya Fan

Display Components

Display Core

Addressable Light

ILI9xxx

Display Core

Addressable Light

ILI9xxx

ILI9341

ILI9342

ILI9481

ILI9341

ILI9342

ILI9481

ILI9486

ILI9488

WSPICOLCD

ILI9486

ILI9488

WSPICOLCD

Inkplate

LCD Display

MAX7219

Inkplate

LCD Display

MAX7219

MAX7219 Dot Matrix

Nextion

PCD8544 (Nokia 5110/ 3310)

MAX7219 Dot Matrix

Nextion

PCD8544 (Nokia 5110/ 3310)

PVVX MiThermometer

SSD1306

SSD1322

PVVX MiThermometer

SSD1306

SSD1322

SSD1325

SSD1327

SSD1331

SSD1325

SSD1327

SSD1331

SSD1351

ST7567

ST7735

SSD1351

ST7567

ST7735

ST7789V

ST7796

ST7920

ST7789V

ST7796

ST7920

TM1621

TM1637

TM1638

TM1621

TM1637

TM1638

Waveshare E-Paper

Waveshare E-Paper

Touchscreen Components

Touchscreen Core

EKTF2232

Lilygo T5 4.7"

Touchscreen Core

EKTF2232

Inkplate 6 Plus

Lilygo T5 4.7”

TT21100

XPT2046

GT911

TT21100

XPT2046

GT911

FT63X6

FT63X6

Cover Components

Cover Core

Template Cover

Feedback Cover

Cover Core

Template Cover

Feedback Cover

Endstop Cover

Current-Based Cover

Time-Based Cover

Endstop Cover

Current-Based Cover

Time-Based Cover

Custom Cover

AM43 Cover

Tuya Cover

Custom Cover

AM43 Cover

Tuya Cover

HE60R Cover

HE60R Cover

Text Sensor Components

Text Sensor Core

Home Assistant

MQTT Subscribe Text

Text Sensor Core

Home Assistant

MQTT Subscribe Text

Version

WiFi Info

Ethernet Info

Version

WiFi Info

Ethernet Info

BLE Scanner

Modbus Text Sensor

Template Text Sensor

BLE Scanner

Modbus Text Sensor

Template Text Sensor

Custom Text Sensor

Nextion Text Sensor

Tuya Text Sensor

Custom Text Sensor

Nextion Text Sensor

Tuya Text Sensor

WL-134 Pet Tag Sensor

LibreTiny

WireGuard

WL-134 Pet Tag Sensor

LibreTiny

WireGuard

Climate Components

Climate Core

Bang Bang Controller

Thermostat Controller

Climate Core

Bang Bang Controller

Thermostat Controller

Custom Climate

PID Controller

IR Remote Climate

Custom Climate

PID Controller

IR Remote Climate

Tuya Climate

Midea

Anova Cooker

Tuya Climate

Midea

Anova Cooker

BedJet Climate System

Haier Climate

BedJet Climate System

Haier Climate

Number Components

Number Core

Modbus Number

Template Number

Number Core

Modbus Number

Template Number

Tuya Number

Tuya Number

Select Components

Select Core

Template Select

Modbus Select

Select Core

Template Select

Modbus Select

Tuya Select

Tuya Select

Lock Components

Lock Core

Generic Output Lock

Template Lock

Lock Core

Generic Output Lock

Template Lock

Text Components

Text Core

Template Text

Text Core

Template Text

Media Player Components

Media Player Core

I2S Audio

Media Player Core

I2S Audio

Microphone Components

Microphone Core

I2S Microphone

Microphone Core

I2S Microphone

Speaker Components

Speaker Core

I2S Speaker

Speaker Core

I2S Speaker

Time Components

Time Core

Home Assistant Time

SNTP

Time Core

Home Assistant Time

SNTP

GPS Time

DS1307 RTC

PCF8563 RTC

GPS Time

DS1307 RTC

PCF8563 RTC

PCF85063 RTC

PCF85063 RTC

Home Assistant Companion Components

Bluetooth Proxy

Voice Assistant

micro Wake Word

Bluetooth Proxy

Voice Assistant

micro Wake Word

Sensor

Text Sensor

Binary Sensor

Sensor

Text Sensor

Binary Sensor

Alarm Control Panel Components

Alarm Control Panel Core

Template Alarm Control Panel

Alarm Control Panel Core

Template Alarm Control Panel

Miscellaneous Components

Remote Receiver

Remote Transmitter

Status LED

Remote Receiver

Remote Transmitter

Status LED

Display Menu Core

LCD Menu

Graphical Display Menu

Display Menu Core

LCD Menu

Graphical Display Menu

Matrix Keypad

Wiegand Reader

HTTP Request

Matrix Keypad

Wiegand Reader

HTTP Request

mDNS

Sun

GPS

mDNS

Sun

GPS

Bluetooth Proxy

ESP32 BLE Client

ESP32 BLE Tracker

Bluetooth Proxy

ESP32 BLE Client

ESP32 BLE Tracker

ESP32 BLE Beacon

ESP32 Ethernet

ESP32 Camera

ESP32 BLE Beacon

ESP32 Ethernet

ESP32 Camera

ESP32 Camera Web Server

I²S Audio

Stepper

ESP32 Camera Web Server

I²S Audio

Stepper

Servo

Sprinkler

Grove TB6612FNG

Servo

Sprinkler

Grove TB6612FNG

PCA6416A I/O Expander

PCA9554 I/O Expander

PCF8574 I/O Expander

PCA6416A I/O Expander

PCA9554 I/O Expander

PCF8574 I/O Expander

MAX6956 I/O expander - I²C Bus

MCP230XX I/O Expander - I²C Bus

TCA9548A I²C Multiplexer

MAX6956 I/O expander - I²C Bus

MCP230XX I/O Expander - I²C Bus

TCA9548A I²C Multiplexer

MCP23SXX I/O Expander - SPI Bus

SX1509 I/O Expander

SN74HC165 I/O Expander

MCP23SXX I/O Expander - SPI Bus

SX1509 I/O Expander

SN74HC165 I/O Expander

SN74HC595 I/O Expander

XL9535 I/O Expander

SIM800L

SN74HC595 I/O Expander

XL9535 I/O Expander

SIM800L

DFPlayer

Captive Portal

Improv via BLE

DFPlayer

Captive Portal

Improv via BLE

Improv via Serial

Debug Component

TM1651 Battery Display

Improv via Serial

Debug Component

TM1651 Battery Display

RF Bridge

Tuya MCU

Modbus Controller

RF Bridge

Tuya MCU

Modbus Controller

Exposure Notifications

RTTTL Buzzer

Prometheus

Exposure Notifications

RTTTL Buzzer

Prometheus

PipSolar - compatible PV Inverter

Grow Fingerprint Reader

SML

PipSolar - compatible PV Inverter

Grow Fingerprint Reader

SML

Atlas Scientific Peristaltic Pump

Resol VBus

WireGuard

Atlas Scientific Peristaltic Pump

Resol VBus

WireGuard

Demo

Copy

Demo

Copy

Additional Custom Components

Generic Custom Component

Custom I²C Component

Custom SPI Component

Generic Custom Component

Custom I²C Component

Custom SPI Component

Custom UART Component

Custom UART Component

Cookbook

Lambda Magic: Tips and Tricks

Garage Door Template Cover

Time & Temperature on OLED Display

Lambda Magic: Tips and Tricks

Garage Door Template Cover

Time & Temperature on OLED Display

ESP32 Water Leak Detector

BME280 Environment extras

Non-Invasive Power Meter

ESP32 Water Leak Detector

BME280 Environment extras

Non-Invasive Power Meter

Sonoff Fishpond Pump

Arduino Port Extender

EHMTX a matrix status/text display

Sonoff Fishpond Pump

Arduino Port Extender

EHMTX a matrix status/text display

Share data directly between ESPHome nodes

Share data directly between ESPHome nodes

Do you have other awesome automations or cool setups? Please feel free to add them to the documentation for others to copy. See Contributing.

If you’d like to share configurations for specific devices, please contribute to our ESPHome Devices database.