---
title: "BLE ESL"
description: "BLE ESL is a Marketplace integration for Home Assistant. It has 50 installs sharing analytics, works locally and was last updated November 5, 2026."
canonical: "https://vulpo.app/integrations/marketplace/eigger-hass-ble-esl"
url: "https://vulpo.app/integrations/marketplace/eigger-hass-ble-esl.md"
last-updated: "2026-11-05"
version: "1.4"
---

# BLE ESL

> BLE ESL is a Marketplace integration for Home Assistant. It has 50 installs sharing analytics, works locally and was last updated November 5, 2026.

From the [repository description](https://github.com/eigger/hass-ble-esl):

> Home Assistant integration for BLE e-paper shelf labels (ESL) — WOLINK, easyTag, PickSmart, XTE, ETAG protocols

[Open in My Home Assistant](https://my.home-assistant.io/redirect/marketplace_repository/?owner=eigger&repository=hass-ble-esl&category=integration)

On Home Assistant 2026.10 or older? [Open it in HACS](https://my.home-assistant.io/redirect/hacs_repository/?owner=eigger&repository=hass-ble-esl&category=integration)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **Found by itself**: Home Assistant spots it on the network and offers to add it.
- **From the Marketplace**: Installed through the Marketplace, formerly HACS.
- **Actively maintained**: Its author released or pushed a change in the last six months.

## Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

### Connect

- **Device**

### Select Tag Model

- **Model**

### After setup

- **Model**: ESL display resolution and model type.
- **Retry Count**: Number of times to retry writing to the device before giving up.
- **Prevent Duplicate Send**: Skip writing when the new image is identical to the last one sent.
- **Debounce Delay (ms)**: Delay before writing to device. New writes cancel pending ones. 0 = disabled (immediate write).

Texts from the code of [eigger/hass-ble-esl](https://github.com/eigger/hass-ble-esl).

## Entities

- **Binary sensors**: Connectivity, Display In Sync
- **Images**: Last Updated Content, Preview Content
- **Sensors**: Battery, Battery Voltage, Temperature, Write Duration, Failure Count, Last Failure Time
- **Switches**: Write Lock
- **Texts**: Alias

## Actions

- **Write Label**: Write a label image to a BLE ESL device.
  Fields: Payload, Rotate, Background, Dry Run
- **Write Guarded Label**: Write a label image with guards applied (duplicate, write lock, debounce).
  Fields: Payload, Rotate, Background, Dry Run, Debounce Override

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.
- **Repair notices**: Notices it can show in Settings, Repairs:
  An automation carries a designer source that is no longer used

## From the README

> A Home Assistant custom integration that sends layouts to Bluetooth Low Energy electronic shelf labels.
>
> Use one Home Assistant action to send calendars, weather, sensor readings or photos to e-paper tags over Bluetooth. Tags can run for months to years on one battery without a gateway, cloud service or wiring.
>
> - Write layouts with ble\_esl.write using imagespec elements and Jinja templates. ble\_esl.write\_guarded skips unchanged images, respects Write Lock and debounces bursts.
> - ESL Manager, a sidebar dashboard and visual designer that exports the same payload as YAML.
> - Failure sensors and a diagnostics download that say at which stage a write failed and through which radio.

From the README of [eigger/hass-ble-esl](https://github.com/eigger/hass-ble-esl#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened.

## At a glance

- Kind: Marketplace integration
- Category: [Hubs and protocols](https://vulpo.app/integrations/category/hubs-and-protocols.md), Wireless protocols
- Number: 50 installs sharing analytics; 23 GitHub stars
- Connection: Works locally
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: v1.10.2, last updated November 5, 2026
- Domain: `ble_esl`
- Source: <https://github.com/eigger/hass-ble-esl>
- Issues: <https://github.com/eigger/hass-ble-esl/issues>
- Screenshot: https://vulpo.app/integrations-img/18799a3bfdb722c9.webp (from eigger/hass-ble-esl's README)
- Screenshot: https://vulpo.app/integrations-img/99d0dccb00c9e7c9.webp (from eigger/hass-ble-esl's README)

In Vulpo: Quick Toggle card, Chart card, Apple Watch, Control Center

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-11-05. Source: https://vulpo.app/integrations/marketplace/eigger-hass-ble-esl

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/eigger-hass-ble-esl
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml