Installing CO2 Gadget on your ESP32 board is a one-click process thanks to the web-based installer powered by ESP Web Tools: compatible with Chrome, Edge and Chromium-based browsers, with no need to install anything on your computer. Here you’ll find the 13 supported board models, the flashing instructions, the binary table and the guide to compiling from source code.
Which version to install
There are two versions available. Choose the one that best suits your needs:
- Beta (recommended): includes the latest features — BTHome v2, low-power binary mode, improved MQTT Discovery, graphs with CSV/JSON export, web calibration, screenshots via HTTP, and over 40 REST endpoints. The branch
developmentIt is compiled and published every time a change is made. If you encounter any problems, please report them at GitHub or in the Telegram group. - Stable release: a version tested approximately two years ago (
v0.14.006). It only makes sense if you need maximum stability for a critical deployment and the new features do not add any value for you. If you’re using it for personal, home or educational purposes, the Beta is the better option.
Beta installation (recommended)
Click INSTALL in the row corresponding to your board. Connect your ESP32 via USB and select the port when the browser dialogue box opens. Within a few seconds, the beta firmware will be flashed onto your device.
| Taste | Version | Date | Install |
|---|---|---|---|
| TTGO_TDISPLAY_SANDWICH | 0.16.031-beta | 26-10-2026 | |
| TTGO_TDISPLAY | 0.16.031-beta | 26-10-2026 | |
| TDISPLAY_S3 | 0.16.031-beta | 26-10-2026 | |
| esp32dev_OLED | 0.16.031-beta | 26-10-2026 | |
| esp32dev | 0.16.031-beta | 26-10-2026 | |
| esp32dev_ST7789_240x320 | 0.16.031-beta | 26-10-2026 | |
| ttgo-t5-EINKBOARDGDEM0213B74 | 0.16.031-beta | 26-10-2026 | |
| ttgo-t5-EINKBOARDDEPG0213BN | 0.16.031-beta | 26-10-2026 | |
| ttgo-t5-EINKBOARDGDEW0213M21 | 0.16.031-beta | 26-10-2026 | |
| ttgo-t7-EINKBOARDGDEM029T94 | 0.16.031-beta | 26-10-2026 | |
| ttgo-t7-WEACT_GDEH0154D67 | 0.16.031-beta | 26-10-2026 | |
| ttgo-t7-WEACT_DEPG0213BN | 0.16.031-beta | 26-10-2026 | |
| ttgo-t7-WEACT_GxEPD2_290_BS | 0.16.031-beta | 26-10-2026 |
First time? Tick the «Erase device» box in the installer to clear the previous configuration (recommended if you’re switching from a different firmware).
Installation of the stable release version
If you prefer the stable version, you can also install it directly from your browser. The procedure is the same: find your motherboard in the table, click INSTALL, connect via USB and wait.
| Taste | Version | Date | Install |
|---|---|---|---|
| TTGO_TDISPLAY_SANDWICH | v0.014.006 | 09-06-2024 | |
| TTGO_TDISPLAY | v0.014.006 | 09-06-2024 | |
| TDISPLAY_S3 | v0.014.006 | 09-06-2024 | |
| esp32dev_OLED | v0.014.006 | 09-06-2024 | |
| esp32dev | v0.014.006 | 09-06-2024 | |
| esp32dev_ST7789_240x320 | v0.014.006 | 09-06-2024 | |
| ttgo-t5-EINKBOARDGDEM0213B74 | v0.014.006 | 09-06-2024 | |
| ttgo-t5-EINKBOARDDEPG0213BN | v0.014.006 | 09-06-2024 | |
| ttgo-t5-EINKBOARDGDEW0213M21 | v0.014.006 | 09-06-2024 | |
| ttgo-t7-EINKBOARDGDEM029T94 | v0.014.006 | 09-06-2024 | |
| ttgo-t7-WEACT_GDEH0154D67 | v0.014.006 | 09-06-2024 | |
| ttgo-t7-WEACT_DEPG0213BN | v0.014.006 | 09-06-2024 | |
| ttgo-t7-WEACT_GxEPD2_290_BS | v0.014.006 | 09-06-2024 |
Choose the flavour you want to install and follow the instructions.
- TTGO_TDISPLAY_SANDWICH: TTGO T-Display board with I2C sensor on alternate pins (SDA on 21 and SCD on 22)
- TTGO_TDISPLAY: TTGO T-Display board with I2C sensor on normal pins (SDA on 21 and SCD on 22)
- TDISPLAY_S3: T-Display S3 board with I2C sensor on normal pins (SDA on 42 and SCD on 43). Available soon.
- esp32dev_OLED: Generic ESP32 board with OLED display (SH1106 128X64)
- esp32dev: Generic ESP32 board without display
- esp32dev_ST7789_240×320: Generic board with 240×320 TFT display and ST7789 controller
- ttgo-t5-EINKBOARDGDEM0213B74: Lilygo TTGO T5 with e-Ink display with panel GDEM0213B74
- ttgo-t5-EINKBOARDDEPG0213BN: Lilygo TTGO T5 with e-Ink display with DEPG0213BN panel
- ttgo-t5-EINKBOARDGDEW0213M21: Lilygo TTGO T5 with e-Ink display with panel GDEW0213M21
- ttgo-t7-EINKBOARDGDEM029T94: Generic ESP32 board with e-Ink display GDEM029T94
- ttgo-t7-WEACT_GDEH0154D67: Generic ESP32 board with WeAct Studio e-Ink display GDEH0154D67
- ttgo-t7-WEACT_DEPG0213BN: Generic ESP32 board with WeAct Studio e-Ink display DEPG0213BN
- ttgo-t7-WEACT_GxEPD2_290_BS: Generic ESP32 board with WeAct Studio e-Ink display GDEM029T94 BS
Optional, clear the memory:
When uploading the firmware you have the option to select "Erase device", which will first erase the ESP32 memory and reset all settings. Recommended when installing CO2 Gadget for the first time.
This version does not include BTHome, low-power binary mode or the latest MQTT improvements.
Download binaries
All binaries are available at GitHub Releases. Download the file for your board and flash it using any ESP32-compatible tool.
Compilation from source code
For developers: clone the repository, install PlatformIO and compile for your board:
git clone https://github.com/melkati/CO2-Gadget.git
cd CO2-Gadget
pio run -e TTGO_TDISPLAY --target uploadPlate models
CO2 Gadget supports 13 different boards. The most popular ones are:
- TTGO_TDISPLAY — 240×135 TFT, the most commonly used
- TDISPLAY_S3 — ESP32-S3 with a 320×170 TFT display
- esp32dev_OLED — Generic board with OLED
- esp32dev — No screen, headless
- ttgo-t5-* — E-Ink 2.13
- ttgo-t7-* — E-Ink 2.9 and 1.54
First start-up
When you switch it on for the first time, BLE is enabled and Wi-Fi is disabled. Use the MyAmbiance app to set up Wi-Fi or connect to the captive portal. All default settings are optimised so that the meter works as soon as you switch it on.
Notes
- Use a good USB cable: charging cables do not always transfer data
- If you’re having connection problems, try ‘Erase device’ before flashing
- The Arduino IDE is not officially supported: use PlatformIO
- After flashing, wait 30 seconds before disconnecting the USB cable
Did you find this useful? Share this article. Also have a look at the Menu Guide. Any questions? Ask on the Telegram group.
Hey,
First of all, thank you for your update and all your hard work over the last few years!!
I just wanted to let you know that the following package is broken and is displaying the following error:
«Downloading firmware’ https://emariete.com/wp-content/uploads/firmware/CO2-Gadget/beta/CO2-Gadget-ttgo-t5-EINKBOARDDEPG0213BN-0.16.014-bootloader.bin failed: 404″
It would be great if this could be sorted out.
Thank you in advance and best regards
Michael
Hi.
I’m sorry for the inconvenience.
Please, could you try again?
Hi Michael, thanks for the report and sorry for the long wait.
The 404 error was not on your side: the beta binaries were being served from a location that had started returning «not found», so the installer was unable to download them. We’ve moved all firmware binaries to a new, reliable host and released a fresh beta, v0.16.031-beta.
Please open the installation guide again, perform a hard refresh (Ctrl+F5 / Cmd+Shift+R) so that the page loads the updated version table, and click INSTALL on the ttgo-t5-EINKBOARDDEPG0213BN row. It should now download the four files and flash as normal. If you are upgrading from an older firmware version, it is recommended that you tick «Erase device» first.
If anything still isn’t working, please let me know and I’ll look into it. Thank you for your patience!
Hi, thank you for your ongoing efforts to update the CO₂ gadget!
I tried to install the latest beta firmware, but I’m getting a 404 error. The stable firmware works fine, but I can’t download CO2-Gadget-esp32dev-0.16.014-bootloader.bin. Could you please sort this out? Thanks!
Hi.
I’m sorry for the inconvenience.
Please, could you try again?
Hi Cadster, thanks for letting us know, and sorry it took so long.
You were right: the download URLs for the beta binaries were returning a 404 error, whilst the stable ones worked. We’ve moved the beta firmware to a new host and released v0.16.031-beta, so the beta table now points to files that actually exist.
Please reload the installation guide using a hard refresh (Ctrl+F5 / Cmd+Shift+R) and click INSTALL on the esp32dev row. The installer should download all four parts and flash them without any errors. If you are upgrading, we recommend selecting «Erase device».
Let me know if it works for you now. Thanks!
Hello! Thank you for all your hard work on the CO₂ gadget! I’m sorry to bother you, but I’m getting the same error as described in previous comments – I tried to install the latest beta firmware, but I’m getting a 404 error. The stable firmware works fine, but I can’t download CO2-Gadget-esp32dev-0.16.014-bootloader.bin. Is it possible to sort this out? Thank you!
Hi!
Thank you for reporting this, and for your kind words about the CO₂ Gadget.
I’m sorry for the inconvenience. It seems there is indeed a problem with downloading the latest beta firmware. I’ll look into it and try to sort it out over the weekend.
In the meantime, if the stable firmware is working correctly for you, I recommend continuing to use that version until the beta download issue has been resolved.
Thanks again for letting me know, and for your patience and support! 😊
Kind regards,
Mariete
Hi Snekounec, thanks for bringing this to our attention again and sorry for the delay — you spotted it just before the fix was implemented.
The cause was the same 404 error on the beta binary URLs that other users had reported. The beta firmware is now hosted on a new, stable server and we have released v0.16.031-beta, so the download links are working again.
Please perform a hard refresh of the installation guide (Ctrl+F5 / Cmd+Shift+R) and click INSTALL on the esp32dev row. It should now download and flash as normal. We recommend using «Erase device» when flashing from a different version.
If you still come across any errors, please let me know. Thank you for your patience and for your kind words!