OpenMQTTGatewayOne gateway, many technologies

Bridge RF, Infrared, Bluetooth LE, LoRa and more to MQTT, and to your home automation platform.

Overview of the protocols and compatible controllers

📶

Bluetooth Low Energy

Decodes more than 100 BLE sensors out of the box thanks to Theengs Decoder — Mi Flora, Xiaomi, Govee, Inkbird, SwitchBot and more.

📡

RF 433/315/868/915MHz

Receive and transmit RF signals with RTL_433, RCSwitch, KaKu or Pilight — weather stations, door sensors, remotes, PIR sensors.

🔴

Infrared & LoRa

Make your old TV or AC smart through IR, or reach far-away sensors with LoRa.

🏠

Home automation ready

Home Assistant MQTT auto-discovery enabled by default. Works with OpenHAB, Domoticz, Jeedom, Node-RED, FHEM and any MQTT-capable software.

⚡

Easy to install

Flash an ESP32 or ESP8266 directly from your browser, then configure WiFi and MQTT through a web portal. No development tools required.

🔧

Extensible

Add sensors (BME280, DHT, INA226...) and actuators (relays, PWM, LED), secure connections with TLS, and update over the air.

Development Version

This is the edge version of the documentation, built from commit d8ffa3. It is under active development and may contain bugs, incomplete features, or breaking changes. Use it at your own risk.

How it works

OpenMQTTGateway is a firmware for ESP32 and ESP8266 boards that translates your devices' signals into MQTT messages — and back. One board replaces a drawer full of proprietary bridges.

🌡️Your devicesBLE · RF · IR · LoRa

⇄

📟OpenMQTTGatewayESP32 / ESP8266

⇄

🔀MQTT brokerMosquitto...

⇄

🏠Your controllerHome Assistant, OpenHAB...

Decodes more than 100 BLE devices and many RF protocols (433/315/868/915MHz) through RTL_433 decoders — and the BLE decoding also runs on Raspberry Pi, Windows or Linux with Theengs Gateway.

What will you automate?

🌱Water the garden when a Mi Flora sensor says the soil is dry

🚪Detect opened doors and windows through 433MHz or BLE

🧊Get alerted when the fridge or freezer gets too warm

📺Make your old TV or AC smart through infrared control

⌚Run a welcome scenario when your smartwatch comes home

🥩Follow your meat temperature while cooking with an Inkbird IBBQ

💧Detect water leakage or smoke remotely

📬Know when a distant mailbox is opened, over LoRa

🌡️Trigger a fan from a Mi Jia temperature and humidity sensor

🚨Sound a siren if something is going wrong

⚖️Log your weight automatically from a BLE scale

🛞Monitor your vehicle tire pressure

The limit is your imagination 😀

See it in action

433MHz and BLE gateway video by Andreas Spiess

433MHz and BLE gatewayby Andreas Spiess

BLE gatewayby Andreas Spiess

RTL_433 on ESP32by Tech Mind

LoRa gatewayby PricelessToolkit

In the press: ESPHome vs OMG · ZedIoT · HomeTechHacker · Squix · Hackaday · CNX Software · RTL-SDR · LWN.net

Under the hood

Home Assistant auto-discoveryMessage deduplicationSimple MQTT APISignal forward & repeatWiFi onboarding portalWeb UI configurationWhitelist & blacklistTLS secure connectionsOver-the-air updatesLocal first, cloud optional

Support the project

Theengs Bridge, BLE to MQTT gateway with Ethernet and external antenna

Theengs Bridge — ready-to-use BLE gateway

Pre-flashed with OpenMQTTGateway, with an Ethernet port and an external antenna for enhanced BLE range. Every purchase directly funds the project.

Get the Theengs Bridge

You can also sponsor the development to help keep the project healthy and evolving.

The material and information contained in this documentation is for general information purposes only. You should not rely upon it as a basis for making any business, legal or any other decisions. There is no warranty given on this documentation content; if you decide to follow the information and materials given it is at your own risk.