• Collection of air purifiers that can be more or less easily hacked to run ESPHome instead of cloud-based firmware.
• Eliminating cloud dependency and enabling native Home Assistant integration for air purifiers.

I like Wi-Fi enabled air purifiers! But I hate the fact that they all depend on a cloud service.

I've run Home Assistant and custom-built ESPHome devices at home for quite some time, and found a project that let me flash custom, ESPHome-based firmware onto a Levoit Core 300S (which I already owned). Wi-Fi enabled air purifiers often use an ESP32 for the Wi-Fi side plus a separate MCU to manage the purifier itself (speeds, air-quality sensor, auto mode, …), with a UART link between the two.

This started as a handful of custom ESPHome firmware and hardware projects for Levoit air purifiers, and is slowly growing into the broader collection you see here.

Every purifier covered here at a glance — how it's converted to ESPHome, its specs, and how involved the teardown is. Click a model or its Guide for the full write-up.

Methods — how the custom firmware ends up on the device:

• 🟢 Flash — flash ESPHome straight onto the device's own ESP32 (works where it isn't locked — most Levoits). Easiest; back up the stock firmware first.
• 🔵 Add ESP — wire in a separate ESP32 and disable the original (EN→GND). Needed when secure boot blocks reflashing, and fully reversible.
• 🔴 Custom HW — replace the controller board / build custom hardware.

CADR and Noise are manufacturer specs. Disassembly is a rough effort estimate (Easy / Medium / Hard) — check the linked Guide before you start.

➕ Add your own!

Got another air purifier running ESPHome? Add it to the list — open a Pull Request or share it in Discussions. Two requirements: it has to be an air purifier, and it has to run (or be made to run) ESPHome. In-repo components or external projects (like the IKEA ones above) are both welcome.

• Added Philips Series 600 Support
• Rework started to esphome hacked air purifiers from free levoit project
• added Links to Ikea hacks

• Added Levoit Everest Air via Levoit component

These external ESPHome components expose each purifier natively to Home Assistant — no cloud, no custom Lovelace hacks. The exact entities depend on the model and its MCU firmware, but across the supported devices the components provide:

• Fan — native Home Assistant fan with model-based speed levels (1–3 / 1–4) and preset modes (Manual, Auto, Sleep, Pet, Turbo, …).
• Auto Mode — model-specific auto modes (Default / Quiet / Room Size / Eco / Efficient) with a configurable target room size where supported.
• Air Quality — PM2.5, plus PM1.0 / PM10 and an AQI value on models with the sensors for it.
• Filter Lifetime — computed filter life %, low-filter warning, current CADR, configurable lifespan, and a reset button (calculated by the component, works on every model).
• Display & Light — display on/off, child lock, ambient light auto-dim, and night-light control where present.
• Timer — run timer plus readable initial and remaining-time sensors.
• Info & Debug — MCU firmware version, ESP component version, and device error status.
• Model extras — e.g. the Everest Air's motorized vent louver and the Sprout / Everest Air cover-door sensor.

See the per-feature tables further down for exactly which entity each model exposes.

Supports the Philips-made (Versuni) 600 Series sold under the MUJI brand — AC0650/10 and AC0651/10 — for now. It works much like the Levoit component, just speaking Philips' slightly different FE FF binary UART protocol. These units are secure-boot locked, so the approach is to add your own ESP32 and disable the original module.

Requires: ESPHome 2026.05.3+

The Core and Vital Series share quite a lot on the protocol level, while having some differences based on model and MCU version. This is an external ESPHome component that supports all (WIP!) Core and Vital Air Purifiers.

Can be flashed to the original ESP32-SOLO-C1 or also installed on top (replace original), check 'Installation'

The Levoit Sprout additionally uses the levoit_audio component for white noise playback (MP3 from SPIFFS via I2S) — note its vendored dr_mp3.h build dependency.

Requires: ESPHome 2026.05.3+

• Levoit LV-PUR 131S – Custom Firmware + MCU & sensor upgrade + hardware hack
• Levoit Mini – Custom PCB, 3D parts, hardware hack

Core200s

Core300s - with Air Quality and Auto

Native Home Assistant Fan component, with preset support. Available speed levels and presets are based on model.

The Everest Air adds a motorized vent louver and a cover/door sensor not present on the other models:

The vent angle is set as a number entity (45° = nearly closed/upward, 90° = fully open/forward). The MCU echoes the current angle back in status tag 0x14, and it reads 0 while the unit is powered off.

⁽¹⁾ Computed by the component (not received from MCU), works on all models.

Auto mode options per model:

• Added Levoit Everest Air support
• Everest Air motorized vent louver as a number (45–90°, vent_angle, CMD 02 12 55)
• Everest Air back/cover door sensor as a binary_sensor (cover_open, status tag 0x15) — unit powers off while open

• ESPHome min version updated to 2026.5.3
• Correct Core400S CADR and Room Size limits (@EdenNelson)
• Fix fan preset modes for newer ESPHome (set_supported_preset_modes moved to FanTraits) (@EdenNelson)
• Fix Core300S/400S falsely reporting "Sensor error" (removed incorrect status byte mapping)
• Add Vital 200S Pro support for MCU FW 2.0.0 with bulk-prefs SET (@TheDave94)
• LevoitSwitch: set has_state on publish to match Select/Number behavior (@TheDave94)
• Fix race condition where the led stays blinking even after conenction is restored (@Ahmed-max)

• Added Core 600S support: 4 fan speeds, 4 auto modes (Default / Quiet / Room Size / ECO), Light Detect switch, CADR 641 m³/h
• Added Vital 200S (Pro) support: same protocol as Vital 100S, tested with original ESP
• Updated Auto Mode select to show model-specific options (3 for Core/Vital, 4 for Core 600S)

• Added Core200s support and readme / example.
• Renamed/moved repo to tuct/levoit - for easier collaboration with pull requests, ...

• Works with ESPHome 2026.3+
• Sensors - added state class measurement -> allow statistics to be tracked

• The component has been updated for ESPHome 2025.12.5

Not part of this repo, but built on the same idea — an ESPHome component talking the vendor's UART protocol to the purifier's MCU:

• dhewg/esphome-miot — Xiaomi MIoT serial protocol. Flashes the device's built-in ESP gateway (no extra hardware) and covers a range of Xiaomi/Mi air purifiers: Mi Air Purifier 3 / 3H / 3C, Pro H, and Smart 4 / 4 Lite / 4 Pro / Elite. Also supports other Xiaomi MIoT devices (humidifiers, fans, …).

If you have a Levoit model that isn't supported yet, or a newer MCU firmware on a supported model, a UART dump is the best way to contribute.

What's needed:

• A logic analyzer capture of the UART traffic between the ESP32 and the MCU (both directions)
• The MCU firmware version (visible in the Levoit app or via mcu_version sensor once flashed)
• A description of any features the device has (fan speeds, auto modes, sensors, lights, etc.)

Open an issue or pull request in the repo with the dump attached.

The ESP32 and MCU communicate over UART at 115200 baud, 8N1. See Levoit UART Protocol Details for a full description of the packet format. To capture traffic:

Check the individual device README for teardown steps, PCB photos, and the exact solder points to use for your model.

1. Open the device and locate the correct solder points — see the individual device README for the exact pads

   Note: The debug pin header RX/TX pins are used to flash the ESP32. They are not the UART line between the ESP32 and the MCU. You need to tap into the dedicated ESP↔MCU communication pads (test points or vias near the ESP32), not the header.

2. Connect a logic analyzer to both the ESP TX and MCU TX lines, with a shared GND

3. In Saleae Logic 2, add an Async Serial analyzer on each channel:

   • Baud rate: 115200
   • Bits per frame: 8
   • Stop bits: 1
   • No parity

4. Power on the device and capture separate, clearly labelled dumps for each action — one action per capture makes it much easier to identify which bytes correspond to which command:

   Dump	Action
   bootup	Power on → wait until Wi-Fi connected and app shows online
   speed_1-4_app	Switch through fan speeds 1 → 2 → 3 → 4 via the app
   speed_1-4_device	Switch through fan speeds 1 → 2 → 3 → 4 via the physical buttons
   mode_app	Switch through all modes (Manual / Auto / Sleep / Pet) via the app
   mode_device	Switch through all modes via the physical buttons
   auto_mode	Switch through all auto mode sub-options (Default / Quiet / Room Size / etc.)
   display_on_off	Toggle the display on and off
   child_lock	Enable and disable child lock
   timer	Set a timer via the app
   filter_reset	Reset filter stats
   (model-specific)	Any unique features: lights, white noise, CO₂ sensor, etc.

   Label each file clearly (e.g. core300s_2.0.11_speed_app.txt).

   Example: See devices/levoit-sprout/uart/uart_dumps for a real Sprout dump covering boot, speed switching, light modes, and white noise — each section labelled with the action performed.

5. In Logic 2, use Export Data → export the analyzer results as a text/CSV file (not the .sal session). A plain text file with the decoded HLA output is all that's needed.

A High-Level Analyzer for the Levoit UART protocol is included in logic2/levoit_uart/.

Install:

1. Open Logic 2 → Extensions (puzzle icon) → Load Existing Extension
2. Select the logic2/levoit_uart/ folder

Use:

1. Add an Async Serial analyzer on the ESP TX channel (115200 baud, 8N1) — this is ESP→MCU traffic
2. Add a second Async Serial analyzer on the MCU TX channel — this is MCU→ESP traffic
3. Add a Levoit UART Extractor HLA on top of the first Async Serial, set Channel to ESP->MCU
4. Add a second Levoit UART Extractor HLA on top of the second Async Serial, set Channel to MCU->ESP
5. Decoded packets appear as: [MCU->ESP] RESP(0x52) | CMD=01 40 41 | PAY=00 01 ...

Both HLAs run side by side so you can see the full request/response exchange in one view.

See logic2/levoit_uart/README.md for full details.

Not my projects, but worth checking out:

• levoit-vital-200s + levoit-vital-200s pro, levoit-vital-100s?
• https://github.com/mulcmu/esphome-levoit-core300s
• https://github.com/acvigue/esphome-levoit-air-purifier

• How to open Levoit's
• How to open Levoit's smaller

Levoit UART Protocol Details