MQTT2NotifySend

Mqtt2notifisend

? Puente entre mqtt y freedesktop.org notifica notificaciones de escritorio (ubuntu y otras distribuciones), para enviar notificaciones a su escritorio a través de MQTT.

Empezando

 # Dependencies are: libnotify-bin, mosquitto-clients, jq, coreutils
sudo apt install libnotify-bin mosquitto-clients jq coreutils

# Download the script & set as executable (optional)
curl -O https://raw.githubusercontent.com/David-Lor/MQTT2NotifySend/master/mqtt2notifysend.sh
chmod u+x mqtt2notifysend.sh

# Run!
./mqtt2notifysend.sh -h localhost -t notifications

# Send a message to the broker from other terminal window
mosquitto_pub -h localhost -t notifications -m " { " title " : " Custom notification " , " text " : " Hello world " } "

• Los argumentos de script para la conexión MQTT son los mismos que se usan con el comando mosquitto_sub (ejecutar ./mqt2notifysend.sh --help para saber más).
• El script espera una cadena JSON como carga útil, con las siguientes etiquetas:
  • title : Título de notificación (opcional)
  • text : Cuerpo de notificación (requerido)
  • level : Nivel de urgencia de notificación (opcional; uno de: low , normal , critical ; predeterminado: normal )
  • iconB64 : imagen de icono de notificación, codificada como cadena base64 (opcional)

Variables de entorno

Ciertas configuraciones se pueden ajustar utilizando las siguientes variables de entorno:

• RECONNECTION_DELAY : tiempo para esperar entre intentos de conexión, en segundos (predeterminado: 5 )
• DEFAULT_TITLE : Título predeterminado para notificaciones enviadas sin título (predeterminado: MQTT2NotifySend )
• DEFAULT_LEVEL : nivel de notificación predeterminado para notificaciones enviadas sin nivel (predeterminado: normal )
• LOG_ENABLE : si es true o 1 , habilita los registros de script (predeterminado: false )
• ICON_BASE_PATH : donde se descarga el archivo de icono de notificación, para cada notificación. Esta es una ruta absoluta/relativa del archivo, utilizada como prefijo (predeterminado: /tmp/mqtt2notifysend-icon )
• ICON_DELETE_DELAY : segundos para esperar entre el icono se decodifica y se elimina. No puede ser cero, ya que el comando Notifysend puede retrasarse un poco y el icono puede eliminarse cuando aparece la notificación, sin mostrar el icono (predeterminado: 5 )

Uso:

LOG_ENABLE=true RECONNECTION_DELAY=1 DEFAULT_TITLE= " Very important notification " DEFAULT_LEVEL=critical 
    bash mqtt2notifysend.sh -h localhost -t notifications

Colegio de cambios

• 0.3.0 - Soporte de envío de icono para notificaciones, como cadena codificada en Base64
• 0.2.1 - Permitir deshabilitar los registros; registros deshabilitados de forma predeterminada; modifica la sintaxis del script; Describe las variables de entorno en ReadMe
• 0.2.0 - nueva versión inicial de Bash desde cero
• V0.1.0 - (desaprobado) nueva versión inicial desde cero (Branch Python/Develop)
• V0.1 - Versión inicial (en desuso) (Branch Python/Master)

HACER

• Soporte de cargas útiles que no son JSON (solo texto y texto de título dividido por delimitador)
• Identificar cuándo falla Mosquitto_Sub debido al error de error de conexión o al error de entrada del usuario (args)
• Validar las dependencias instaladas antes de conectarse
• Iconos de apoyo enviados por URL