https://github.com/aidun/netflux
simple metric pusher for Netatmo Weather API and InfluxDB
https://github.com/aidun/netflux
golang influxdb iot netatmo netatmo-weather-station
Last synced: 5 months ago
JSON representation
simple metric pusher for Netatmo Weather API and InfluxDB
- Host: GitHub
- URL: https://github.com/aidun/netflux
- Owner: aidun
- License: apache-2.0
- Created: 2019-03-05T21:36:50.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-07-18T17:29:49.000Z (12 months ago)
- Last Synced: 2025-10-05T21:52:50.572Z (9 months ago)
- Topics: golang, influxdb, iot, netatmo, netatmo-weather-station
- Language: Go
- Homepage:
- Size: 26.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# netflux
Netflux is a simple daemon which collects weather metrics from the netatmo weather api and push this metrics to an influxdb instance.
Supported metrics:
- temperature
- hummidity
Netflux will check for all stations linked to your account and all modules linked to your stations. If a module support none of the metrics, it will not be recognized.
## Installation
### Docker
```
docker pull aidun/netflux
```
### From Source
In order to install netflux from source, you have to install go 1.11 with go modules support.
```
git clone https://github.com/aidun/netflux.git
cd netflux
go test ./...
go build
chmod +x netflux
cp netflux /usr/local/bin
```
## Usage
### Requirements
- influxdb with authentication
- Netatmo account developer account
- Netatmo application https://dev.netatmo.com/myaccount/createanapp
### Commandline
Netflux requires some commandline parameters:
```
netflux is a tool to push netatmo weather data to influxdb
Usage:
netflux [flags]
Flags:
-h, --help help for netflux
--influxdb_database string Database
--influxdb_password string Password of the influxdb user
--influxdb_url string API of the influxdb instance
--influxdb_user string User of the influxdb with write access
--netatmo_clientid string Client-ID to Netatmo Weather API
--netatmo_clientsecret string Client-Secret to Netatmo Weather API
--netatmo_password string Password to Netatmo Weather API
--netatmo_user string User to Netatmo Weather API
```
An example call looks like:
```
netflux
--influxdb_database netatmo \
--influxdb_user user_with_write_access_to_influxdb \
--influxdb_password start123 \
--influxdb_url http://localhost:8086 \
--netatmo_user youraccount@example.com \
--netatmo_password start123
--netatmo_clientid 123456
--netatmo_clientsecret 654321
```