# Cigar Oasis: reconstructing SmartHumidor cloud control

> The Cigar Oasis Home Assistant integration reconstructs the SmartHumidor app’s cloud calls for humidity and temperature readings and setpoint control. The author captured app traffic with mitmproxy, documented the login and device endpoints, and implemented Python scripts and a Home Assistant package.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/bjohnson135/homeassistant-cigar-oasis>
- Primary source: <https://github.com/bjohnson135/homeassistant-cigar-oasis/blob/eea0f1d7c4ce1dad75cf8c35f079bff91010cacc/docs/API.md>
- Catalog page: <https://awesomerea.org/resources/cigar-oasis-smarthumidor-case/>
- Record JSON: <https://awesomerea.org/resources/cigar-oasis-smarthumidor-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/cigar-oasis-smarthumidor-case/index.md)

## Requirements & limits

- **Prerequisites:** A Cigar Oasis 3.0, Home Assistant and a SmartHumidor account; active subscription is effectively required for setpoint control.
- **Limits:** Readings and setpoint changes follow the device’s roughly hourly cloud sync.
- **License:** MIT license.

## Primary sources

1. <https://github.com/bjohnson135/homeassistant-cigar-oasis/blob/eea0f1d7c4ce1dad75cf8c35f079bff91010cacc/docs/API.md>
2. <https://github.com/bjohnson135/homeassistant-cigar-oasis/blob/eea0f1d7c4ce1dad75cf8c35f079bff91010cacc/README.md>

## More in Protocols

- [qss-switch-api: reconstructing QNAP QSS switch control](https://awesomerea.org/resources/qss-switch-api-case/index.md) · Case study
- [NameLand: reconstructing Casio KL-A45 serial printing](https://awesomerea.org/resources/nameland-case/index.md) · Case study
- [dh360d: reconstructing the Darkflash cooler LCD protocol](https://awesomerea.org/resources/dh360d-case/index.md) · Case study
- [Sony WH-CH720N: reconstructing headset control over RFCOMM](https://awesomerea.org/resources/sony-wh-ch720n-linux-case/index.md) · Case study
- [Kosmos CP1: reconstructing the CP2 cassette format](https://awesomerea.org/resources/kosmos-cp1-cassette-case/index.md) · Case study
- [ISDT PB40: reconstructing a power bank's BLE protocol](https://awesomerea.org/resources/pb40-bluetooth-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.