No Description

Fabian Peter Hammerle 2c662d165d pylint-import-requirements: switch to unreleased fix for custom loaders 4 years ago
.github aee870c751 prepare glib loop to receive dbus signals 4 years ago
systemctl_mqtt aee870c751 prepare glib loop to receive dbus signals 4 years ago
tests aee870c751 prepare glib loop to receive dbus signals 4 years ago
.dockerignore 74669520c1 added dockerfile & docker-compose.yml 4 years ago
.gitignore ab72c20968 pipeline / pipenv: explicitly specify python version to workaround pipenv picking highest available 4 years ago
.isort.cfg 04fcb2b7a9 isort: added config to workaround persistent misclassification of paho.mqtt.client 4 years ago
.pylintrc 1574063886 mqtt message on topic systemctl/hostname/poweroff schedules poweroff with delay of 4 seconds 4 years ago
CHANGELOG.md 6a26d41b3f release v0.1.1 4 years ago
COPYING 1574063886 mqtt message on topic systemctl/hostname/poweroff schedules poweroff with delay of 4 seconds 4 years ago
Dockerfile 92230331f6 docker: remove pipenv from runtime image 4 years ago
Pipfile 2c662d165d pylint-import-requirements: switch to unreleased fix for custom loaders 4 years ago
Pipfile.lock 2c662d165d pylint-import-requirements: switch to unreleased fix for custom loaders 4 years ago
README.md aee870c751 prepare glib loop to receive dbus signals 4 years ago
docker-apparmor-profile cd56f43371 rename apparmor-profile -> docker-apparmor-profile 4 years ago
docker-compose.yml e57f5aaeea added link to merge request enabling apparmor for raspberrypi's official kernel 4 years ago
mypy.ini 1574063886 mqtt message on topic systemctl/hostname/poweroff schedules poweroff with delay of 4 seconds 4 years ago
setup.py aee870c751 prepare glib loop to receive dbus signals 4 years ago

README.md

systemctl-mqtt

CI Pipeline Status Coverage Status Last Release Compatible Python Versions

MQTT client triggering shutdown on systemd-based systems

Setup

$ pip3 install --user --upgrade systemctl-mqtt
$ systemctl-mqtt --mqtt-host HOSTNAME_OR_IP_ADDRESS

On debian-based systems, dependencies can optionally be installed via:

$ sudo apt-get install --no-install-recommends python3-dbus python3-gi python3-paho-mqtt

Schedule poweroff by sending a MQTT message to topic systemctl/hostname/poweroff.

$ mosquitto_pub -h MQTT_BROKER -t systemctl/hostname/poweroff -n

Home Assistant 🏡

Sample Setup

# https://www.home-assistant.io/docs/mqtt/broker/#configuration-variables
mqtt:
  broker: BROKER_HOSTNAME_OR_IP_ADDRESS
  # credentials, additional options…

script:
  poweroff_raspberry_pi:
    sequence:
      service: mqtt.publish
      data:
        topic: systemctl/raspberrypi/poweroff

homeassistant:
  customize:
    script.poweroff_raspberry_pi:
      friendly_name: poweroff pi
      icon: mdi:power

Docker 🐳

  1. Clone this repository.
  2. Edit docker-compose.yml.
  3. Load AppArmor profile: sudo apparmor_parser ./docker-apparmor-profile
  4. sudo docker-compose up --build

Pre-built docker image are available at https://hub.docker.com/r/fphammerle/systemctl-mqtt/tags

Annotation of signed tags docker/* contains docker image digests: https://github.com/fphammerle/systemctl-mqtt/tags

MQTT Authentication

systemctl-mqtt --mqtt-username me --mqtt-password secret …
# or
systemctl-mqtt --mqtt-username me --mqtt-password-file /var/lib/secrets/mqtt/password …