No description
Find a file
2026-03-03 03:24:39 +01:00
app Enhance index.html layout and styling: improve visual design, add animations, and update links for better user experience 2026-03-03 02:57:46 +01:00
debian Improve temperature reading handling and error reporting; remove obsolete install file and add social media assets 2026-03-03 02:17:26 +01:00
static Refactor code structure for improved readability and maintainability 2026-03-03 02:27:45 +01:00
.gitignore Initial commit 2022-08-25 23:25:05 +02:00
com.vitexsoftware.thermoservice.metainfo.xml Enhance installation instructions, add Zabbix integration, and improve documentation 2026-03-02 23:52:31 +01:00
LICENSE Initial commit 2022-08-25 23:25:05 +02:00
README.md Add Zabbix template for DS18B20 temperature sensor monitoring with triggers and graphs 2026-03-03 03:24:39 +01:00
social.png Improve temperature reading handling and error reporting; remove obsolete install file and add social media assets 2026-03-03 02:17:26 +01:00
social.xcf Improve temperature reading handling and error reporting; remove obsolete install file and add social media assets 2026-03-03 02:17:26 +01:00
thermo Add error handling for missing DS18B20 temperature sensor 2026-03-02 23:30:04 +01:00
thermoservice.py app skeleton 2022-08-26 00:48:38 +02:00
zabbix_template_thermoservice.yaml Add Zabbix template for DS18B20 temperature sensor monitoring with triggers and graphs 2026-03-03 03:24:39 +01:00

thermoservice

Temperature sharing service for DS18B20

Pi Thermo Service

Installation

Debian / Ubuntu

sudo curl -fsSL http://repo.vitexsoftware.com/KEY.gpg -o /usr/share/keyrings/vitexsoftware-archive-keyring.gpg && \
echo "Types: deb
URIs: http://repo.vitexsoftware.com/
Suites: $(lsb_release -sc)
Components: main
Signed-By: /usr/share/keyrings/vitexsoftware-archive-keyring.gpg" | sudo tee /etc/apt/sources.list.d/vitexsoftware.sources

sudo apt update
sudo apt install thermoservice

Zabbix Integration

To enable Zabbix monitoring of temperature sensors:

sudo apt install thermometer-zabbix

This installs Zabbix Agent configuration that provides the following user parameters:

  • sensor.temp.value - Current temperature in Celsius
  • sensor.temp.celsius - Current temperature in Celsius

The Zabbix agent will automatically restart after installation to load the new configuration.

Zabbix Template:

A pre-configured Zabbix 7.4 template is available in the repository at zabbix_template_thermoservice.yaml. Import this template into your Zabbix server to automatically configure:

  • Temperature monitoring items
  • Threshold triggers (high temperature, freezing, no data alerts)
  • Temperature trend graphs

To use the template:

  1. Import zabbix_template_thermoservice.yaml into Zabbix
  2. Assign the "DS18B20 Temperature Sensor" template to your host
  3. Temperature data will be collected automatically

Usage

Run command thermo to print current temperature to stdout:

$ thermo
23.125

The service automatically starts and exposes a web interface on port 5000, displaying the current temperature from the DS18B20 sensor.

Description

Thermoservice is a lightweight Flask-based web service designed for Raspberry Pi and similar devices equipped with DS18B20 temperature sensors. It reads temperature data from the 1-Wire interface and provides both a command-line tool and a web interface for monitoring temperature readings.

Features:

  • Simple command-line temperature reading with thermo command
  • Web interface on port 5000 for real-time temperature display with cyberpunk futuristic design
  • Systemd service integration for automatic startup
  • Designed for DS18B20 digital temperature sensors
  • Graceful handling when no sensor hardware is detected
  • Optional Zabbix Agent integration for monitoring (thermometer-zabbix package)
  • Pre-configured Zabbix 7.4 template with triggers and graphs

Requirements:

  • DS18B20 temperature sensor connected via 1-Wire interface
  • Raspberry Pi or compatible device with 1-Wire support enabled