{"id":17482214,"url":"https://github.com/celliesprojects/co2-display-esp32","last_synced_at":"2026-04-27T23:38:12.515Z","repository":{"id":258159197,"uuid":"840801741","full_name":"CelliesProjects/co2-display-esp32","owner":"CelliesProjects","description":"An app to show indoor co2 levels and air quality","archived":false,"fork":false,"pushed_at":"2024-10-19T13:02:05.000Z","size":85674,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-20T05:47:19.138Z","etag":null,"topics":["co2-monitoring","esp32-4848s040","esp32-s3","indoor-air-quality","platformio","senseair-s8","sht31","visualcrossing-api","visualcrossingweather"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CelliesProjects.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-10T18:14:49.000Z","updated_at":"2024-10-19T12:34:54.000Z","dependencies_parsed_at":"2024-11-04T15:35:07.707Z","dependency_job_id":null,"html_url":"https://github.com/CelliesProjects/co2-display-esp32","commit_stats":{"total_commits":77,"total_committers":1,"mean_commits":77.0,"dds":0.0,"last_synced_commit":"17f8fdb9e91437370a94e63ff0a0591d25e3475e"},"previous_names":["celliesprojects/co2-display-esp32"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CelliesProjects%2Fco2-display-esp32","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CelliesProjects%2Fco2-display-esp32/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CelliesProjects%2Fco2-display-esp32/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CelliesProjects%2Fco2-display-esp32/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CelliesProjects","download_url":"https://codeload.github.com/CelliesProjects/co2-display-esp32/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246035960,"owners_count":20713180,"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":["co2-monitoring","esp32-4848s040","esp32-s3","indoor-air-quality","platformio","senseair-s8","sht31","visualcrossing-api","visualcrossingweather"],"created_at":"2024-10-18T23:04:41.916Z","updated_at":"2026-04-27T23:38:12.509Z","avatar_url":"https://github.com/CelliesProjects.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CO\u003csub\u003e2\u003c/sub\u003e display esp32\n\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/bdbc66cdcdfd46ab99144949714cc822)](https://app.codacy.com/gh/CelliesProjects/co2-display-esp32/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade)\n\nThis is a [PlatformIO](https://platformio.org/) project designed to display CO\u003csub\u003e2\u003c/sub\u003e levels using a [Panel ESP32-4848S040](https://homeding.github.io/boards/esp32s3/panel-4848S040.htm).  \nIt reads data from a Senseair S8 CO\u003csub\u003e2\u003c/sub\u003e sensor and an SHT31 temperature and humidity sensor, displaying the real-time readings and the history of the last hour.\n\n![screenshot.bmp](https://github.com/user-attachments/files/24259777/screenshot.bmp)\n\nSensors are on a separate sensor board and the sensor values are pushed to this board through websocket.  \nThis setup is chosen because the SenseAir S8 CO\u003csub\u003e2\u003c/sub\u003e sensor uses up to 300mA when reading and this makes the tft screen flicker during reading when the CO\u003csub\u003e2\u003c/sub\u003e sensor is on the same board as the display.  \nYou can find the sensor code at the [SensorHub repo](https://github.com/CelliesProjects/SensorHub).\n\nThere is also weather forecast data shown which is retrieved from [visualcrossing.com](https://www.visualcrossing.com/).  \nYou will need to setup an account with visualcrossing to be able to download weather data. 1000 free API credits per day are included in the free accounts. No CC needed.   \nYou can setup your free account [here](https://www.visualcrossing.com/weather-api).\n\n### Installation\n\nAssuming you already have the [SensorHub](https://github.com/CelliesProjects/SensorHub) running and a [visualcrossing account](https://www.visualcrossing.com/weather-api) API key you can use these steps to install:\n\n1.  Clone this repository.\n```bash\ngit clone https://github.com/CelliesProjects/co2-display-esp32.git\n```\n\n 2.  Open the extracted folder in PlatformIO and add a `secrets.h` file to the `include` folder with the following content:  \n ```c++\n#ifndef SECRETS\n#define SECRETS\n\nconst char *WIFI_SSID = \"network\";\nconst char *WIFI_PSK = \"password\";\n\nconst char *VISUAL_CROSSING_CITY = \"city\";\nconst char *VISUAL_CROSSING_COUNTRY = \"country\";\nconst char *VISUAL_CROSSING_API_KEY = \"your api key\";\n\n#endif\n```\n3. Build and upload the firmware to the ESP32.\n\n### Done!\n\nIf all went well the board will now search for the sensorhub and connect automagically.\n\n## License\nThis project is licensed under the MIT License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcelliesprojects%2Fco2-display-esp32","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcelliesprojects%2Fco2-display-esp32","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcelliesprojects%2Fco2-display-esp32/lists"}