Mirror of meteo - My environmental monitoring solution
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Felix 8068a51a3a Add home-assistant integration 11 months ago
Sensors Documentation refactoring 1 year ago
cmd Renamed www to web 1 year ago
home-assistant Add home-assistant integration 11 months ago
internal Reorganized repo 1 year ago
utils Deployment bugfix 2 years ago
web Renamed www to web 1 year ago
.gitignore Renamed www to web 1 year ago
.travis.yml Fixed requirements for CI 1 year ago
LICENSE Initial commit 5 years ago
Makefile Fixed requirements for CI 1 year ago
README.md JSON section improved 1 year ago
go.mod Changed to go 1.11 1 year ago
go.sum Reorganized repo 1 year ago
meteo.png Icon 4 years ago
meteo.toml Client color support 2 years ago
meteod.service Moved main files 2 years ago
meteod.toml Date selector 1 year ago



Build Status

Lightweight environmental monitoring solution

This project aims to provide a centralized environmental and room monitoring system for different sensors. The meteo-daemon (meteod) runs on a centralised server instance, that collect all sensor data from different sensor nodes.

Client can attach to this server instance in order to read out the different readings of the sensors.


Requires go >= 1.9.x and the following repositories

go get "github.com/BurntSushi/toml"
go get "github.com/gorilla/mux"
go get "github.com/mattn/go-sqlite3"
go get "github.com/eclipse/paho.mqtt.golang"

A quick way of installing the requirements is

$ make req                      # Installs requirements


Currently manually. See meteod.toml for information


meteod stores all data in a Sqlite3 database. By default meteod.db is taken, but the filename can be configured in meteod.toml.


There is currently a very simple CLI client available: meteo

meteo REMOTE

$ meteo http://meteo-service.local/
  *   1 meteo-cluster          2019-05-14-17:24:01   22.51C|23.00 %rel| 95337hPa


Requires go >= 1.9.x and "github.com/BurntSushi/toml"

$ make req-meteo
$ make meteo


Currently manually. See meteod.toml


Current meteo sensors are ESP32 based nodes with a BME280 sensor, but in principal every node that is able to push data via MQTT can be attached to the server.

See the EPS32 folder in Sensors for the current supported node

MQTT packets

MQTT is considered as trusted network in meteod. New station will be automatically added. If you want to have better access control, please use http and disable MQTT in your config file.

Every node that publishes MQTT packets in the given format is accepted.

# Node ID: 1, replace in topic and payload

## meteo packets
TOPIC:    meteo/1
PAYLOAD:  {"id":1,"name":"Node","t":23.36,"hum":44.56,"p":99720.89}

## lightning packet
TOPIC:    meteo/lightning/1
PAYLOAD:  {"node":1,"timestamp":0,"distance":12.1}
# if the timestamp is 0, the server replaces it with it's current time

Data-Push via HTTP

To push data via HTTP, you need a access token. The token identifies where the data belongs to.

The data is expected to be in the following json format

{ "token":"test", "T":32.0, "Hum": 33.1, "P":1013.5 }

Example-curl script to push data to station 5

$ curl 'http://localhost:8802/station/5' -X POST -H "Content-Type: application/json" --data { "token":"test", "T":32.0, "Hum": 33.1, "P":1013.5 }