--- title: "OpenDisplay" description: "OpenDisplay is a Marketplace integration for Home Assistant. It has 160 installs sharing analytics, works locally and was last updated October 26, 2026." canonical: "https://vulpo.app/integrations/marketplace/opendisplay-home-assistant-integration" url: "https://vulpo.app/integrations/marketplace/opendisplay-home-assistant-integration.md" last-updated: "2026-10-22" version: "1.4" --- # OpenDisplay > OpenDisplay is a Marketplace integration for Home Assistant. It has 160 installs sharing analytics, works locally and was last updated October 26, 2026. OpenDisplay is an integration for controlling and monitoring OpenDisplay E-Paper displays from Home Assistant. Devices are found automatically over Bluetooth, or over mDNS when on WiFi, and the integration works locally. Each device gets an image entity for its display content, sensors for chip temperature, battery voltage, signal strength and last seen, a firmware update entity, and binary sensors for pending updates and WiFi. Actions cover uploading an image, drawing a custom image on one or several devices, flashing the LED, sounding the buzzer or playing a melody, and writing an NFC tag. Battery-powered tags in deep sleep have content queued until the next wake, and options control sleep handling, queue timeout and upload speed. Encrypted devices ask for their AES key during setup. Automatic summary of the README and code of OpenDisplay/Home\_Assistant\_Integration. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=OpenDisplay&repository=Home_Assistant_Integration&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=OpenDisplay&repository=Home_Assistant_Integration&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 the Bluetooth device to set up. ### Encryption required - **Encryption key**: Enter the 32-character hexadecimal AES-128 encryption key for this device. Also asked when signing in again. ### After setup - **Deep sleep handling**: Automatic follows the device's own power configuration (battery power with deep sleep enabled). Force on or off to override. - **Missed wake cycles before unavailable**: How many expected wake-ups the device may miss before its entities are marked unavailable. - **Queued content timeout (hours)**: How long content queued for a sleeping device waits for a wake before it expires. - **Try connecting before queueing**: Before queueing an image for a sleeping device, make one quick connection attempt in case it is actually awake (missed advertisements, always-on radios). Adds at most a few seconds when the device really is asleep. - **Blocks sent per acknowledgment**: How many image frames the device receives before it sends one acknowledgment during a fast (sliding-window) upload. Higher values reduce round trips; the effective value is capped by the device and the maximum frames in flight. - **Maximum upload frames in flight**: Maximum number of image frames kept in flight at once during a fast (sliding-window) upload. Higher values raise throughput on slow (proxy) links. Set to 1 to disable fast transfer and use the classic one-frame-at-a-time upload. Texts from the code of [OpenDisplay/Home\_Assistant\_Integration](https://github.com/OpenDisplay/Home_Assistant_Integration). ## Entities - **Binary sensors**: Update pending, WiFi - **Images**: Display content - **Sensors**: Chip temperature, Battery voltage, Signal strength (RSSI), Last seen - **Updates**: Firmware ## Actions - **Upload image**: Uploads an image to an OpenDisplay device. Fields: Device, Dither mode, Fit mode, Image, Refresh mode, Rotation, Tone compression, Use measured palette, Refine dithering - **Activate LED**: Triggers an LED flash pattern on an OpenDisplay device. Fields: Device, LED instance, Brightness, Repeats, Color 1, Flash count 1, Flash delay 1, Step delay 1, Color 2, Flash count 2 - **Activate buzzer**: Triggers a buzzer tone on an OpenDisplay device. For multi-note melodies, see Play buzzer melody. Fields: Device, Buzzer instance, Frequency, Duration, Repeats - **Write NFC tag**: Writes an NDEF record (URL, text, or MIME data such as a vCard) to the NFC chip of an OpenDisplay device. Fields: Device, Record type, Content, MIME type - **Play buzzer melody**: Plays a multi-note melody on an OpenDisplay device's buzzer. Fields: Device, Buzzer instance, Notes, Tempo, Repeats, Default note duration, Default length - **Draw custom image**: Draws a custom image on one or more OpenDisplay devices. Fields: Payload, Background color, Rotation, Dither mode, Refresh type, Use measured palette, Dry run ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. ## From the README > Home Assistant Integration for the OpenDisplay project, enabling control and monitoring of E-Paper displays through Home Assistant. > > The OpenDisplay 4.26" mono and 7.3" colour kits From the README of [OpenDisplay/Home\_Assistant\_Integration](https://github.com/OpenDisplay/Home_Assistant_Integration#readme), [Apache License 2.0](https://spdx.org/licenses/Apache-2.0.html). Shortened. ## At a glance - Kind: Marketplace integration - Number: 160 installs sharing analytics; 89 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: 3.1.0, last updated October 26, 2026 - Domain: `opendisplay` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/63b22a5b5a193c41.webp (from OpenDisplay/Home\_Assistant\_Integration's README) - Screenshot: https://vulpo.app/integrations-img/a439303ae2c3a653.webp (from OpenDisplay/Home\_Assistant\_Integration's README) In Vulpo: Chart card, Apple Watch 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-10-22. Source: https://vulpo.app/integrations/marketplace/opendisplay-home-assistant-integration --- - HTML version of this page: https://vulpo.app/integrations/marketplace/opendisplay-home-assistant-integration - 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