https://github.com/dhellmann/tempmon
Python-based temperature monitor daemon
https://github.com/dhellmann/tempmon
Last synced: over 1 year ago
JSON representation
Python-based temperature monitor daemon
- Host: GitHub
- URL: https://github.com/dhellmann/tempmon
- Owner: dhellmann
- License: apache-2.0
- Created: 2015-03-21T13:07:13.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2015-04-25T15:08:42.000Z (about 11 years ago)
- Last Synced: 2025-01-04T22:35:10.147Z (over 1 year ago)
- Language: Python
- Size: 203 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
=======================================
tempmon -- Temperature monitor daemon
=======================================
tempmon uses temperusb_ to read temperature value from TEMPer_ sensors
on the USB bus and OWM_ to find the local reported temperature and
publishes the results to `plot.ly`_
.. _temperusb: https://pypi.python.org/pypi/temperusb
.. _TEMPer: http://www.amazon.com/gp/product/B002VA813U/ref=as_li_tl?ie=UTF8&camp=1789&creative=390957&creativeASIN=B002VA813U&linkCode=as2&tag=hellflynet-20&linkId=VHDXEZ2QB74BXBM5
.. _plot.ly: https://plot.ly
.. _OWM: http://openweathermap.org/
Setup
=====
#. Sign up for a plot.ly account.
#. From your `plot.ly settings page`_, create one stream token per
sensor device
#. Install tempmon and its dependencies. A virtualenv works fine for
this.
#. Sign up for a OWM account and find your API key on `your settings
page `__.
4. Create a configuration file using YAML syntax and containing at
least the basic plot.ly authentication data:
::
plotly:
username:
api-key:
stream-tokens:
- token1
- token2
weather:
api-key:
place: "City, State"
5. Run ``tempmon -c $CONFIG_FILENAME``. Add ``-v`` to see the log
output on the console for debugging.
Other Configuration Settings
============================
graph-title
The title of the graph defaults to "Temperature".
retention-period
The number of days for which data should be kept. tempmon uses this
value to compute the number of points to save based on the
``frequency``.
frequency
How often to collect data, in minutes. This value is approximately
how fast tempmon will poll the device. The minimum frequency is 1
minute.
units
The units to report the temperature in. Either ``celsius`` or
``fahrenheit``. Defaults to ``fahrenheit``.
.. _plot.ly settings page: https://plot.ly/settings/api