{"id":20999775,"url":"https://github.com/orangecoding/homebridge-influx","last_synced_at":"2025-05-14T23:31:13.688Z","repository":{"id":50627805,"uuid":"344501717","full_name":"orangecoding/homebridge-influx","owner":"orangecoding","description":"Homebridge Plugin to pull temperature and humidity values from Influx","archived":false,"fork":false,"pushed_at":"2021-03-10T11:52:34.000Z","size":102,"stargazers_count":8,"open_issues_count":2,"forks_count":5,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-25T18:21:40.302Z","etag":null,"topics":["homebridge","homekit","influx","influxdb","javascript"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/orangecoding.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}},"created_at":"2021-03-04T14:26:45.000Z","updated_at":"2024-11-21T08:38:24.000Z","dependencies_parsed_at":"2022-09-26T17:41:32.509Z","dependency_job_id":null,"html_url":"https://github.com/orangecoding/homebridge-influx","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orangecoding%2Fhomebridge-influx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orangecoding%2Fhomebridge-influx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orangecoding%2Fhomebridge-influx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orangecoding%2Fhomebridge-influx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/orangecoding","download_url":"https://codeload.github.com/orangecoding/homebridge-influx/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254248129,"owners_count":22038971,"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":["homebridge","homekit","influx","influxdb","javascript"],"created_at":"2024-11-19T08:08:13.700Z","updated_at":"2025-05-14T23:31:08.646Z","avatar_url":"https://github.com/orangecoding.png","language":"JavaScript","readme":"# homebridge-influx ![npm](https://img.shields.io/npm/v/homebridge-influx?style=flat-square)\n\nA Homebridge plugin that exposes temperature and humidity from an InfluxDB instance. It is collecting always the latest value from a measurement.\n\n\n## Install\n\nInstall the plugin using:\n\n```bash\nnpm i -g homebridge-influx\n```\n\n\n## Configure\n\nAdd to the `accessories` field of your Homebridge `config.json` file:\n\n```\n{\n  ...\n  \"accessories\": [\n      ...\n      {\n        \"accessory\": \"Homebridge-Influx\",\n        \"name\": \"SomeName\",  // Name for the sensors\n\n        // Optional names for each sensor\n        \"sensor_names\": {\n          \"temperature\": \"Temperature Sensor\",\n          \"humidity\": \"Humidity Sensor\"\n        },\n\n        // For influxDB queries\n        \"schema\": {\n          \"temperature\": {\n            \"field\": \"temperature\",\n            \"measurement\": \"air\"\n          },\n          \"humidity\": {\n            \"field\": \"humidity\",\n            \"measurement\": \"air\"\n          }\n        },\n        \"influx\": {\n          \"host\": \"127.0.0.1\",\n          \"database\": \"homeserver\"\n        }\n      }\n    ]\n}\n```\n\n## Note\nThe fields in `sensor_names` are optional. You however need to set at least 1. If you do not supply `temperature` for instance, no temperature sensor will be registered.\n\n#### Influx config\nThe `influx` configuration object is passed as-is to the `influx` npm library, so you can use all the options it supports. \nSee [here](https://node-influx.github.io/class/src/index.js~InfluxDB.html#instance-constructor-constructor)\n\n# Influx 2\n\nThis plugin is also compatible with Influx 2, however in order to make it work, you need to do 2 things.\n\n### Configuration\n\nIn the `influx` part of the configuration, you need to parse in the token.\n\n```json\n        \"host\": \"yourHost.com\",\n        \"port\": \"yourPort\",\n        \"database\": \"someBucket\", //type in the name of the bucket here\n        \"protocol\": \"http\",\n        \"password\": null,\n        \"options\": {\n            \"headers\": {\n                \"Authorization\": \"Token YOUR_TOKEN\"\n            }\n        }\n```\n\nA bucket is mapped to a database. In order to make Influx aware of this mapping, you need to create it. You do this via terminal by running:\n```bash\ninflux v1 dbrp create --db *BUCKET_NAME* --rp *BUCKET_NAME* --bucket-id *BUCKET_ID* --default\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forangecoding%2Fhomebridge-influx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Forangecoding%2Fhomebridge-influx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forangecoding%2Fhomebridge-influx/lists"}