{"id":17222348,"url":"https://github.com/fphammerle/wireless-sensor-mqtt","last_synced_at":"2025-07-21T09:03:00.931Z","repository":{"id":37083144,"uuid":"319636053","full_name":"fphammerle/wireless-sensor-mqtt","owner":"fphammerle","description":"MQTT client reporting measurements of FT017TH wireless thermo/hygrometers, compatible with Home Assistant🌡:house_with_garden: 🐳","archived":false,"fork":false,"pushed_at":"2025-07-18T07:45:36.000Z","size":591,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-18T11:55:23.761Z","etag":null,"topics":["climate-sensor","docker","home-assistant","home-automation","humidity","mqtt","temperature"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/wireless-sensor-mqtt/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fphammerle.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"COPYING","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,"zenodo":null}},"created_at":"2020-12-08T12:45:29.000Z","updated_at":"2025-06-27T05:33:50.000Z","dependencies_parsed_at":"2023-12-15T16:30:09.100Z","dependency_job_id":"99d64e14-ab11-43a3-91dd-fd38a6ab5329","html_url":"https://github.com/fphammerle/wireless-sensor-mqtt","commit_stats":{"total_commits":213,"total_committers":2,"mean_commits":106.5,"dds":0.3145539906103286,"last_synced_commit":"3c43e39dc6fd728dad54e6a15ae2b5fb71a74dd6"},"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"purl":"pkg:github/fphammerle/wireless-sensor-mqtt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fphammerle%2Fwireless-sensor-mqtt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fphammerle%2Fwireless-sensor-mqtt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fphammerle%2Fwireless-sensor-mqtt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fphammerle%2Fwireless-sensor-mqtt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fphammerle","download_url":"https://codeload.github.com/fphammerle/wireless-sensor-mqtt/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fphammerle%2Fwireless-sensor-mqtt/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265774616,"owners_count":23826113,"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":["climate-sensor","docker","home-assistant","home-automation","humidity","mqtt","temperature"],"created_at":"2024-10-15T04:04:56.258Z","updated_at":"2025-07-21T09:03:00.908Z","avatar_url":"https://github.com/fphammerle.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wireless-sensor-mqtt 🌡\n\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![CI Pipeline Status](https://github.com/fphammerle/wireless-sensor-mqtt/workflows/tests/badge.svg)](https://github.com/fphammerle/wireless-sensor-mqtt/actions)\n![Coverage Status](https://ipfs.io/ipfs/QmP8k5H4MkfspFxQxdL2kEZ4QQWQjF8xwPYD35KvNH4CA6/20230429T090002+0200/s3.amazonaws.com/assets.coveralls.io/badges/coveralls_100.svg)\n[![Last Release](https://img.shields.io/pypi/v/wireless-sensor-mqtt.svg)](https://pypi.org/project/wireless-sensor-mqtt/#history)\n[![Compatible Python Versions](https://img.shields.io/pypi/pyversions/wireless-sensor-mqtt.svg)](https://pypi.org/project/wireless-sensor-mqtt/)\n[![DOI](https://zenodo.org/badge/319636053.svg)](https://zenodo.org/badge/latestdoi/319636053)\n\nMQTT client reporting measurements of FT017TH wireless thermo/hygrometers\n\n## Requirements\n\n* MQTT broker\n* [FT017TH](https://github.com/fphammerle/FT017TH-wireless-thermometer-hygrometer-signal#product-details) sensor\n* [CC1101 transceiver](https://www.ti.com/product/CC1101)\n* Linux machine with CC1101 connected to SPI port \u0026 `GDO0` connected to some GPIO pin\n  ([wiring instructions](https://github.com/fphammerle/python-cc1101#wiring-raspberry-pi)\n  for raspberry pi)\n\n## Setup\n\n```sh\n$ pip3 install --user --upgrade wireless-sensor-mqtt\n```\n\n## Usage\n\n```sh\n$ wireless-sensor-mqtt \\\n    --gdo0-gpio-line-name GPIO24 \\\n    --mqtt-host HOSTNAME_OR_IP_ADDRESS \\\n    --mqtt-topic-prefix MQTT_TOPIC_PREFIX\n```\n\nMeasurements will be published on topics\n`MQTT_TOPIC_PREFIX/temperature-degrees-celsius`\nand `MQTT_TOPIC_PREFIX/relative-humidity-percent`\n(e.g., `living-room/temperature-degrees-celsius`\nwith `--mqtt-topic-prefix living-room`).\n\nAdd `--debug` to get debug logs.\n\n### MQTT via TLS\n\nTLS is enabled by default.\nRun `wireless-sensor-mqtt --mqtt-disable-tls …` to disable TLS.\n\n### MQTT Authentication\n\n```sh\nwireless-sensor-mqtt --mqtt-username me --mqtt-password secret …\n# or\nwireless-sensor-mqtt --mqtt-username me --mqtt-password-file /var/lib/secrets/mqtt/password …\n```\n\n## Home Assistant 🏡\n\n[Home Assistant](https://www.home-assistant.io/) will detect two new sensors automatically,\nif connected to the same MQTT broker\nand [MQTT discovery](https://www.home-assistant.io/docs/mqtt/discovery/) is enabled\n(enabled by default since version [0.117.0](https://github.com/home-assistant/core/commit/306ee305747a4f7ba758352503f99f221f0ad85a)).\n\n![homeassistant: discovered sensors](docs/homeassistant/developer-tools-states-v0.117.5-20201208.png)\n\nWhen using a custom `discovery_prefix`, run `wireless-sensor-mqtt --homeassistant-discovery-prefix custom-prefix …`.\n\n## Docker 🐳\n\nPre-built docker images are available at https://hub.docker.com/r/fphammerle/wireless-sensor-mqtt/tags\n\n```sh\n$ sudo docker run --name wireless_sensor_mqtt \\\n    --device /dev/spidev0.0 --device /dev/gpiochip0 \\\n    fphammerle/wireless-sensor-mqtt \\\n    wireless-sensor-mqtt --mqtt-host HOSTNAME_OR_IP_ADDRESS …\n```\n\nOptionally add `--read-only --cap-drop ALL --security-opt no-new-privileges` before image specifier.\n\nAnnotation of signed tags `docker/*` contains docker image digests: https://github.com/fphammerle/wireless-sensor-mqtt/tags\n\n### Docker Compose 🐙\n\n1. Clone this repository.\n2. Edit `docker-compose.yml`.\n3. `sudo docker-compose up --build`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffphammerle%2Fwireless-sensor-mqtt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffphammerle%2Fwireless-sensor-mqtt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffphammerle%2Fwireless-sensor-mqtt/lists"}