{"id":13632005,"url":"https://github.com/pimoroni/enviroplus-python","last_synced_at":"2025-05-16T07:05:11.946Z","repository":{"id":38456682,"uuid":"190585891","full_name":"pimoroni/enviroplus-python","owner":"pimoroni","description":"Python library for the Enviro+ environmental monitoring board","archived":false,"fork":false,"pushed_at":"2025-03-18T16:46:29.000Z","size":539,"stargazers_count":411,"open_issues_count":10,"forks_count":184,"subscribers_count":31,"default_branch":"main","last_synced_at":"2025-05-09T10:17:49.561Z","etag":null,"topics":["hardware-libraries","pypi-package","python","raspberry-pi"],"latest_commit_sha":null,"homepage":"https://shop.pimoroni.com/products/enviro-plus","language":"Shell","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/pimoroni.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2019-06-06T13:25:51.000Z","updated_at":"2025-04-28T19:48:13.000Z","dependencies_parsed_at":"2024-06-16T15:01:25.773Z","dependency_job_id":"8203b615-ea65-44cf-a383-d915bfb1092b","html_url":"https://github.com/pimoroni/enviroplus-python","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pimoroni%2Fenviroplus-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pimoroni%2Fenviroplus-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pimoroni%2Fenviroplus-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pimoroni%2Fenviroplus-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pimoroni","download_url":"https://codeload.github.com/pimoroni/enviroplus-python/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254485056,"owners_count":22078767,"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":["hardware-libraries","pypi-package","python","raspberry-pi"],"created_at":"2024-08-01T22:02:47.795Z","updated_at":"2025-05-16T07:05:06.927Z","avatar_url":"https://github.com/pimoroni.png","language":"Shell","readme":"# Enviro+\n\nDesigned for environmental monitoring, Enviro+ lets you measure air quality (pollutant gases and particulates), temperature, pressure, humidity, light, and noise level. Learn more - https://shop.pimoroni.com/products/enviro-plus\n\n[![Build Status](https://img.shields.io/github/actions/workflow/status/pimoroni/enviroplus-python/test.yml?branch=main)](https://github.com/pimoroni/enviroplus-python/actions/workflows/test.yml)\n[![Coverage Status](https://coveralls.io/repos/github/pimoroni/enviroplus-python/badge.svg?branch=main)](https://coveralls.io/github/pimoroni/enviroplus-python?branch=main)\n[![PyPi Package](https://img.shields.io/pypi/v/enviroplus.svg)](https://pypi.python.org/pypi/enviroplus)\n[![Python Versions](https://img.shields.io/pypi/pyversions/enviroplus.svg)](https://pypi.python.org/pypi/enviroplus)\n\n# Installing\n\n**Note** The code in this repository supports both the Enviro+ and Enviro Mini boards. _The Enviro Mini board does not have the Gas sensor or the breakout for the PM sensor._\n\n![Enviro Plus pHAT](https://raw.githubusercontent.com/pimoroni/enviroplus-python/main/Enviro-Plus-pHAT.jpg)\n![Enviro Mini pHAT](https://raw.githubusercontent.com/pimoroni/enviroplus-python/main/Enviro-mini-pHAT.jpg)\n\n:warning: This library now supports Python 3 only, Python 2 is EOL - https://www.python.org/doc/sunset-python-2/\n\n## Install and configure dependencies from GitHub:\n\n* `git clone https://github.com/pimoroni/enviroplus-python`\n* `cd enviroplus-python`\n* `./install.sh`\n\n**Note** Libraries will be installed in the \"pimoroni\" virtual environment, you will need to activate it to run examples:\n\n```\nsource ~/.virtualenvs/pimoroni/bin/activate\n```\n\n**Note** Raspbian/Raspberry Pi OS Lite users may first need to install git: `sudo apt install git`\n\n## Or... Install from PyPi and configure manually:\n\n* `python3 -m venv --system-site-packages $HOME/.virtualenvs/pimoroni`\n* Run `python3 -m pip install enviroplus`\n\nAnd install additional dependencies:\n\n```bash\nsudo apt install python3-numpy python3-smbus python3-pil python3-setuptools\n```\n\n**Note** this will not perform any of the required configuration changes on your Pi, you may additionally need to:\n\n* Enable i2c: `raspi-config nonint do_i2c 0`\n* Enable SPI: `raspi-config nonint do_spi 0`\n\nAnd if you're using a PMS5003 sensor you will need to:\n\n### Bookworm\n\n* Enable serial: `raspi-config nonint do_serial_hw 0`\n* Disable serial terminal: `raspi-config nonint do_serial_cons 1`\n* Add `dtoverlay=pi3-miniuart-bt` to your `/boot/firmware/config.txt`\n\n### Bullseye\n\n* Enable serial: `raspi-config nonint set_config_var enable_uart 1 /boot/config.txt`\n* Disable serial terminal: `sudo raspi-config nonint do_serial 1`\n* Add `dtoverlay=pi3-miniuart-bt` to your `/boot/config.txt`\n\n## Alternate Software \u0026 User Projects\n\n* Enviro Plus Dashboard - https://gitlab.com/dedSyn4ps3/enviroplus-dashboard - A React-based web dashboard for viewing sensor data\n* Enviro+ Example Projects - https://gitlab.com/dedSyn4ps3/enviroplus-python-projects - Includes original examples plus code to stream to Adafruit IO (more projects coming soon)\n* enviro monitor - https://github.com/roscoe81/enviro-monitor\n* mqtt-all - https://github.com/robmarkcole/rpi-enviro-mqtt - now upstream: [see examples/mqtt-all.py](examples/mqtt-all.py)\n* enviroplus_exporter - https://github.com/tijmenvandenbrink/enviroplus_exporter - Prometheus exporter (with added support for Luftdaten and InfluxDB Cloud)\n* homekit-enviroplus - https://github.com/sighmon/homekit-enviroplus - An Apple HomeKit accessory for the Pimoroni Enviro+\n* go-enviroplus - https://github.com/rubiojr/go-enviroplus - Go modules to read Enviro+ sensors\n* homebridge-enviroplus - https://github.com/mhawkshaw/homebridge-enviroplus - a Homebridge plugin to add the Enviro+ to HomeKit via Homebridge\n* Enviro Plus Web - https://gitlab.com/idotj/enviroplusweb - Simple Flask application serves a web page with the current sensor readings and a graph over a specified time period\n\n## Help \u0026 Support\n\n* GPIO Pinout - https://pinout.xyz/pinout/enviro_plus\n* Support forums - https://forums.pimoroni.com/c/support\n* Discord - https://discord.gg/hr93ByC\n","funding_links":[],"categories":["Shell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpimoroni%2Fenviroplus-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpimoroni%2Fenviroplus-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpimoroni%2Fenviroplus-python/lists"}