{"id":17722828,"url":"https://github.com/chl33/boiler","last_synced_at":"2026-05-11T02:27:49.837Z","repository":{"id":254631283,"uuid":"847098883","full_name":"chl33/Boiler","owner":"chl33","description":"Software for monitoring water level in a home boiler","archived":false,"fork":false,"pushed_at":"2024-12-31T23:41:46.000Z","size":159,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T01:42:32.275Z","etag":null,"topics":["boiler-monitor","esp32","platformio"],"latest_commit_sha":null,"homepage":"https://selectiveappeal.org/posts/room133/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chl33.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-24T21:03:30.000Z","updated_at":"2024-12-31T23:41:49.000Z","dependencies_parsed_at":"2024-08-24T22:27:55.381Z","dependency_job_id":"abdd0006-06c5-4960-b910-143bc6d6b88d","html_url":"https://github.com/chl33/Boiler","commit_stats":null,"previous_names":["chl33/boiler"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chl33%2FBoiler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chl33%2FBoiler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chl33%2FBoiler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chl33%2FBoiler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chl33","download_url":"https://codeload.github.com/chl33/Boiler/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246473273,"owners_count":20783236,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["boiler-monitor","esp32","platformio"],"created_at":"2024-10-25T15:40:35.715Z","updated_at":"2026-05-11T02:27:49.833Z","avatar_url":"https://github.com/chl33.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Boiler133\n\n![Build Status](https://github.com/chl33/boiler/actions/workflows/platformio-run.yaml/badge.svg)\n\nHas your boiler ever shut down because it ran out of water?\nThis is software for monitoring the water level of a boiler, using a PCBA based\n on an ESP32.\nIt is based on the [og3](https://github.com/chl33/og3) C++ framework.\nThe PCBA and project box are shared with the\n [Room133](https://github.com/chl33/Room133) box.\n\nSee the Room133 [blog post](https://selectiveappeal.org/posts/room133/).\n\n## Features\n\n*   **Water Level Monitoring:** Uses a non-contact sensor to detect if the boiler needs refilling.\n*   **Environmental Monitoring:** Measures Temperature and Humidity using an SHTC3 sensor.\n*   **Home Assistant Integration:** Automatically discovers devices in Home Assistant via MQTT.\n*   **Local Display:** Shows status (Water OK/Empty, Temp, Humidity) on an OLED screen.\n*   **Web Interface:** Built-in web server for viewing status and configuring WiFi/MQTT settings.\n*   **OTA Updates:** Supports Over-The-Air firmware updates.\n\n## Hardware\n\n*   **Board:** ESP32 (NodeMCU-32S compatible)\n*   **Sensors:**\n    *   [Taidacent Non Contact Water Level Sensor](https://www.amazon.com/gp/product/B07FC8K28F) (Connected to GPIO 23)\n    *   SHTC3 Temperature \u0026 Humidity Sensor (I2C)\n*   **Display:** SSD1306 OLED Display (I2C)\n*   **LEDs:**\n    *   Red: GPIO 18\n    *   Yellow: GPIO 19\n    *   Blue: GPIO 20\n\n![Sensor on boiler gauge](images/boiler_gauge.jpg)\n\nThis is the board used for running the boiler software, which is in the Room133 project.\n\n![Boiler/Room133 PCBA](images/boiler-board.jpg)\n\nThis is what the device looks like in its 3D printed project box.\n\n![Boiler device](images/boiler-ebox.jpg)\n\n## Getting Started\n\n### Prerequisites\n\n*   [PlatformIO](https://platformio.org/) (VSCode extension or CLI)\n\n### Configuration\n\n1.  Clone the repository.\n2.  Copy `secrets.ini.example` to `secrets.ini`.\n3.  Edit `secrets.ini` to provide your configuration:\n    ```ini\n    [secrets]\n    udpLogTarget = \u003cYour UDP Log Host IP\u003e\n    otaPassword = \u003cYour OTA Password\u003e\n    ```\n\n### Build and Upload\n\nRun the following command to build and upload the firmware:\n\n```bash\npio run -t upload\n```\n\nTo monitor the serial output:\n\n```bash\npio device monitor\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchl33%2Fboiler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchl33%2Fboiler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchl33%2Fboiler/lists"}