home-assistant.io/source/_integrations/lannouncer.markdown
EgonMarmol 0b40534ae1
LANnouncer: Updated dead link (#24658)
The LANnouncer website seems to have died a while ago, and the link to the page is dead, too. For future reference, I have linked to the archive.org version of the page instead.
2022-10-23 00:18:05 +02:00

2.9 KiB

title, description, ha_category, ha_iot_class, ha_release, ha_domain, ha_platforms, ha_integration_type
title description ha_category ha_iot_class ha_release ha_domain ha_platforms ha_integration_type
LANnouncer Instructions on how to add Lannouncer notifications to Home Assistant.
Notifications
Local Push 0.36 lannouncer
notify
integration

The lannouncer notification platform allows you to play spoken messages (TTS) or sounds on an Android device running Lannouncer. This can be useful when you have a wall mounted Android tablet, or an Android device that is permanently powered and turned on and want to use that to play notifications.

To enable Lannouncer notifications in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
notify:
  - name: NOTIFIER_NAME
    platform: lannouncer
    host: HOSTNAME_OR_IP

{% configuration %} name: description: Setting the optional parameter name allows multiple notifiers to be created. The notifier will bind to the service notify.NOTIFIER_NAME. required: false default: notify type: string host: description: The hostname or IP-address of the Android device that is running Lannouncer. required: true type: string port: description: The port on which Lannouncer is running. required: false default: 1035 type: integer {% endconfiguration %}

Installation

You need to install the Lannouncer app and enable the Network (TCP) Listener and Auto-Start Network Listener. You can disable the GCM (Google Cloud) and WAN Messaging and SMS Listener since this integration doesn't use them.

Lannouncer uses the default Android TTS voice. You can tweak that in the Android configuration, or you can install a different TTS engine from the Play Store. You might want to raise the volume in the app settings since that depends on the actual hardware device.

More information can be found here (archived website).

Sending messages

Lannouncer supports two types of messages.

Spoken messages is the default method (speak). You just invoke the notify service with the following JSON and the device will speak out the specified message.

{
  "message": "I'm sorry, I cannot do that Dave."
}

The second method is to play notifications (alarm). There are 4 built-in sounds (chime, doorbell, alarm and siren).

{
  "message": "chime",
  "data": {
    "method": "alarm"
  }
}

You can also request to play a configured additional soundfiles (FILE1, FILE2, FILE3, FILE4 or FILE5). You can configure this file in the app settings.

{
  "message": "FILE1",
  "data": {
    "method": "alarm"
  }
}
The free version only supports one additional soundfile.

To use notifications, please see the getting started with automation page.