Control your display from your home automation system

How it works

One address, two parameters. Call it, and the text replaces your personal message and scrolls across the panel within a minute.

https://www.smartledmessenger.com/push.ashx?key=YOUR_KEY&message=The+laundry+is+done

Where to find your key

Sign in to your customer area, box “Your personal URL”, then “Show my URL”. You get the full address, key included.

Get my personal address

Three things to know before you start

They explain nearly every “it doesn't work” report we get.

Events, which clear themselves

A message stays until the next one. An event — “Gate open”, “Living room light on” — is true for a few minutes. Add slot=evenement and it clears itself.

https://www.smartledmessenger.com/push.ashx?key=YOUR_KEY&message=Gate+open&slot=evenement&duree=5

Home Assistant

Two ways. A command you declare by hand, described below, which suits a text you write yourself. Or the Smart Led Messenger integration, which turns your sensors into sentences on its own.

Installing the integration with HACS

HACS is the add-on manager for Home Assistant. It must be installed already: if “HACS” is not in your left-hand menu, start with the HACS installation guide, then come back here.

Our integration is not in the default HACS list, so you have to tell HACS once where to find it. That is what a custom repository is. Once only — after that, updates arrive like those of any other add-on.

1. In the left-hand menu, open HACS.
2. Top right, click the three dots ⋮, then Custom repositories.
3. In the Repository field, paste this address:

   https://github.com/SmartLedMessenger/ha-smart-led-messenger

4. In the Type list, pick Integration. This is the step most often missed: without it, HACS rejects the repository.
5. Click Add, then close the window.
6. In HACS, search for Smart Led Messenger, open its page, then Download.
7. Restart Home Assistant: Settings → System → the Restart button, top right. Until that restart happens, the integration stays invisible — that is expected.
8. Finally, Settings → Devices & services → Add integration, search for Smart Led Messenger, and paste your key.

Once added, the Configure button opens the list of your entities: tick the ones that should be announced. Three or four beat thirty — the display has a single line.

Updates then arrive on their own: HACS flags the new version on the integration's page, you download it and restart Home Assistant. Your settings are kept. If nothing shows up although a version has been released, HACS has not seen it yet: menu ⋮ → Reload data.

The other way, with nothing to install: a command declared in configuration.yaml that you call from your automations. This is what you want for a text you write yourself.

1. Declare the command

In configuration.yaml, then restart Home Assistant:

# configuration.yaml
rest_command:
  display:
    # Paste your address here, keeping the key exactly as
    # shown in the customer area, including the %2B and %3D.
    url: >-
      https://www.smartledmessenger.com/push.ashx?key=YOUR_KEY&message={{ text | urlencode }}
    method: get

The urlencode filter is essential: without it, a message containing a space, an accent or an ampersand would break the address.

2. Call it

# From an automation, a script, or the developer tools
action: rest_command.display
data:
  text: "The laundry is done"

3. A few handy automations

The washing machine has finished — detected by power draw dropping:

automation:
  - alias: "Display - washing machine done"
    triggers:
      - trigger: numeric_state
        entity_id: sensor.washing_machine_power
        below: 5
        for: "00:05:00"
    actions:
      - action: rest_command.display
        data:
          text: "The laundry is done"

The day's forecast, every morning:

automation:
  - alias: "Display - morning weather"
    triggers:
      - trigger: time
        at: "07:15:00"
    actions:
      - action: rest_command.display
        data:
          text: >-
            Today {{ state_attr('weather.home','temperature') }} degrees,
            {{ states('sensor.air_quality') }}

Clear the message in the evening — the display resumes its other options:

automation:
  - alias: "Display - clear in the evening"
    triggers:
      - trigger: time
        at: "22:00:00"
    actions:
      - action: rest_command.display
        data:
          text: ""

Jeedom

Two ways to do it, depending on whether you prefer graphical scenarios or code.

In a scenario

Add an Action block, choose “HTTP request” and paste the address. Jeedom tags work inside the message:

https://www.smartledmessenger.com/push.ashx?key=YOUR_KEY&message=Living+room+temperature+#[Living room][Thermometer][Temperature]#+degrees

In a Code block

$text = "Alarm triggered in the garage";
$url = "https://www.smartledmessenger.com/push.ashx"
     . "?key=YOUR_KEY"
     . "&message=" . urlencode($text);
file_get_contents($url);

urlencode() takes care of spaces and accents: it's the safest method.

Node-RED

A function node to build the address, an http request node to call it.

“function” node

// msg.payload holds the text to display
const key = "YOUR_KEY";
msg.url = "https://www.smartledmessenger.com/push.ashx"
        + "?key=" + key
        + "&message=" + encodeURIComponent(msg.payload);
return msg;

“http request” node

• Method: GET
• URL: leave blank — it comes from msg.url
• Return: a UTF-8 string

encodeURIComponent handles spaces and accents. Don't apply it to the key, which is already encoded.

Script, terminal, scheduled task

The most direct way, and the best way to check that your key works before putting it into an automation.

Linux, macOS, Raspberry Pi

# --data-urlencode encodes spaces and accents for you
curl --get \
     --data-urlencode "key=YOUR_PLAIN_KEY" \
     --data-urlencode "message=Hello from the Raspberry" \
     https://www.smartledmessenger.com/push.ashx

Windows, PowerShell

$text = "Backup complete"
$url = "https://www.smartledmessenger.com/push.ashx?key=YOUR_KEY&message=" `
     + [uri]::EscapeDataString($text)
Invoke-RestMethod $url

Every morning, via cron

# Bin reminder on Tuesday and Friday at 7am
0 7 * * 2,5 curl -s "https://www.smartledmessenger.com/push.ashx?key=YOUR_KEY&message=Take+out+the+bins"

From Claude, in plain language

Your display also speaks MCP (Model Context Protocol), the protocol used by AI assistants. Once connected, just say “show the London weather on my panel” or “send HAPPY BIRTHDAY GRANDMA”: Claude sets up your display on its own.

Connecting your display to Claude

On claude.ai (or in the Claude app): Settings → Connectors → Add custom connector, then fill in:

YOUR_KEY is the same as for the push link above: the value that follows key= in your personal address, copied exactly as is (see “Where to find your key”).

What Claude can do

If something goes wrong

https://www.smartledmessenger.com/push.ashx?key=YOUR_KEY&message=

A use case that doesn't fit these examples? Write to us — these pages are shaped by your feedback.