https://github.com/froonix/ism-catcher
🌡️ Munin plugin and other stuff for rtl_433
https://github.com/froonix/ism-catcher
433mhz bash munin php rrdtool rtl-sdr twitter
Last synced: 2 months ago
JSON representation
🌡️ Munin plugin and other stuff for rtl_433
- Host: GitHub
- URL: https://github.com/froonix/ism-catcher
- Owner: froonix
- License: gpl-3.0
- Created: 2017-06-01T10:00:54.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-01-02T18:29:22.000Z (over 2 years ago)
- Last Synced: 2024-10-23T22:20:09.066Z (7 months ago)
- Topics: 433mhz, bash, munin, php, rrdtool, rtl-sdr, twitter
- Language: PHP
- Homepage:
- Size: 104 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# ism-catcher
Munin plugin and other stuff for [rtl_433][1].
```
Program to parse the output of rtl_433.
It's designed to work as Munin plugin.
Usage: ism-catcher [--config=] --live
Parse JSON from STDIN, one dataset per line!
Usage: ism-catcher [--config=] --dump=
Dump packets of binary database .
Usage: ism-catcher [--config=] --watch=[, ...]
Follow mode for single or multiple 's.
Usage: ism-catcher [--config=] [{autoconf|config}]
Execute Munin plugin with optional arguments.
=========================
Supported ENV variables
=========================
* hostname = virtual hostname for munin
* ini_file = path to configuration file
```
## Hardware Requirements
* 24/7 running GNU/Linux system with USB port
* DVB-T dongle with [compatible RTL2832(U)][2] chipset
* Compatible wireless sensor (e.g. `THN128` or `THR128`)
## Software Requirements
* Munin master/node setup (+ Webserver for Munin output)
* [rtl_433][1] installation (and JSON-enabled device)
* PHP ≥ 5.5 (with JSON support)
## Data Aggregation
See: `other-scripts/run.sh` & `other-scripts/legacy/rtl_433.sh`
Examples for multiple (split or aggregated) graphs are available at the [wiki](https://github.com/froonix/ism-catcher/wiki).
## Plugin Installation
```bash
# Setup INI file...
cp -vn config/sample.ini ~/.ism.ini
editor ~/.ism.ini
# Setup plugin configuration...
cp -vn plugin-conf.d/ism /etc/munin/plugin-conf.d/
editor /etc/munin/plugin-conf.d/ism
# Enable plugin...
ln -s /full/path/to/ism-catcher /etc/munin/plugins/ism
# Test plugin...
munin-run ism config
munin-run ism
# Restart daemon...
systemctl restart --no-block munin-node
```
[1]: https://github.com/merbanan/rtl_433
[2]: http://amzn.to/2qIxh9n