Metadata-Version: 2.4
Name: psmqtt
Version: 2.6.1
Summary: Utility reporting system health and status via MQTT
Project-URL: Homepage, https://github.com/eschava/psmqtt
Project-URL: Bug Tracker, https://github.com/eschava/psmqtt/issues
Author-email: Eugene Schava <eschava.nospam@gmail.com>, Francesco Montorsi <francesco.montorsi.nospam@gmail.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: jinja2==3.1.6
Requires-Dist: paho-mqtt==2.1.0
Requires-Dist: platformdirs==4.5.1
Requires-Dist: psutil==7.0.0
Requires-Dist: pysmart==1.4.2
Requires-Dist: python-dateutil==2.9.0.post0
Requires-Dist: pyyaml==6.0.3
Requires-Dist: recurrent==0.4.1
Requires-Dist: testcontainers==4.14.0
Requires-Dist: types-paho-mqtt==1.6.0.20240321
Requires-Dist: yamale==6.1.0
Description-Content-Type: text/x-rst

=======
Summary
=======

**PSMQTT** is a cross-platform utility for reporting system and processes
metrics (CPU, memory, disks, network, S.M.A.R.T. disk data, etc) to an MQTT broker.

It integrates seamlessly with `HomeAssistant <https://www.home-assistant.io/>`_
thanks to the support for `MQTT discovery messages <https://www.home-assistant.io/integrations/mqtt/#discovery-messages>`_.

**PSMQTT**  is written in Python and is based on:

* `paho-mqtt <https://github.com/eclipse/paho.mqtt.python>`_ to communicate with the MQTT broker;
* `psutil <https://github.com/giampaolo/psutil>`_ to collect metrics;
* `pySMART <https://github.com/truenas/py-SMART>`_ to collect SMART data from HDDs/SSDs;
* `recurrent <https://github.com/kvh/recurrent>`_ to describe scheduling expressions;
* `jinja2 <https://github.com/alex-foundation/jinja2>`_ to format the data.

============
Installation
============

The suggested installation method is to use the provided `Docker image <doc/install-docker.md>`_.
However alternative installation methods are available for Linux, FreeBSD and Windows:

* Installing from **pypi**: see `Install from pypi doc <doc/install-pypi.md>`_
* Installing from **sources**: see `Install from source doc <doc/install-source.md>`_
* Installing on **FreeBSD**: see `FreeBSD doc <doc/install-freebsd.md>`_
* Installing on **Windows**: see `Windows doc <doc/install-windows.md>`_

=======================
Configuration and usage
=======================

**PSMQTT** is strongly configuration-file-driven.
Please check the `Usage page <doc/usage.md>`_ which contains all documentation on the configuration options for psmqtt.

============
Known issues
============

See `Known issues <doc/known-problems.md>`_.

=======
Support
=======

Please use the `GitHub issue tracker <https://github.com/eschava/psmqtt/issues>`_
to report bugs or request features.
