This is a custom integration for controlling the AWSW WordClock using Home Assistant.
I found this integration made by bluenazgul, who made this using ChatGPT. That integration only had switches for turning on the extra words, and the language selection did not work. I wanted it to have some more functionality, like changing the light colors of the Background, Text and extra words and an option of choosing the language. So that's why I made a fork of that integration and added these features.
- Controls the Background and Text lights, colors and intensity.
- Controls the extra words as lights and colors.
- Automatically detects and registers a WordClock device using its IP address.
- Direct link to the WordClock Web Interface for configuration.
- Supports 7 Languages (German, English, Dutch, French, Italian, Swedish, Spanish)
- Supports unique entities for each word.
- German: "ALARM", "GEBURTSTAG", "MÜLL RAUS BRINGEN", "AUTO", "FEIERTAG", "FORMEL1", "GELBER SACK", "URLAUB", "WERKSTATT", "ZEIT ZUM ZOCKEN", "FRISEUR", "TERMIN"
- English: "COME HERE", "LUNCH TIME", "ALARM", "GARBAGE", "HOLIDAY", "TEMPERATURE", "DATE", "BIRTHDAY", "DOORBELL"
- Dutch: "KOM HIER", "LUNCH TIJD", "ALARM", "AFVAL", "VAKANTIE", "TEMPERATUUR", "DATUM", "VERJAARDAG", "DEURBEL"
- French: "ALARME", "ANNIVERSAIRE", "POUBELLE", "A TABLE", "VACANCES", "VIENS ICI", "SONNETTE", "TEMPERATURE", "DATE"
- Italian: "VIENI QUI", "ORA DI PRANZO", "ALLARME", "VACANZA", "TEMPERATURA", "DATA", "COMPLEANNO", "CAMPANELLO"
- Swedish: "FÖDELSEDAG", "LARM", "HÖGTID", "SEMESTER", "LADDA NER", "LUNCHTID", "KOM HIT", "DÖRRKLOCKA", "TEMPERATUR"
- Spanish: "CUMPLEAÑOS", "ALARMA", "VACACIONES", "DÍA DE BASURA", "FECHA", "HORA DE ALMUERZO", "VEN AQUÍ", "TIMBRE", "TEMPERATURA"
- A working AWSW WordClock with API access enabled with version V4.7.1 or higher.
- https://www.printables.com/model/768062-wordclock-16x16-2024 is the one i use
- Home Assistant version 2024.11 or higher.
- Add this repository to HACS as a custom repository.
- Search for "AWSW WordClock" in the HACS store and install it.
- Restart Home Assistant.
- Download the latest release from the Releases page.
- Extract the contents and copy the
awsw_wordclockfolder to yourcustom_componentsdirectory in Home Assistant.- The path should be:
custom_components/awsw_wordclock/
- The path should be:
- Restart Home Assistant and configure the integration via the integrations page or press the blue button below.
- Go to
Settings > Devices & Services > Add Integration. - Search for "AWSW WordClock".
- Enter following settings:
- the IP address of your WordClock
- the name of your WordClock
- the language you have set for your WordClock
- the polling frequency
- then press "Submit"
- The Background and Text can be used as lights, so you can turn them on and off separately. Additionally, the colors and brightness can be changed. While the WordClock API currently does not support separate brightness levels for the background and text, the brightness is applied uniformly to all texts.
- Each of the extra words (the number of words differs from one language to another) now appears as a light in Home Assistant. You can turn these words on or off directly from the dashboard or use them in automations. In addition to setting a custom color, the integration now retrieves the current RGB LED color for each extra word from the WordClock API. This means that the displayed color in Home Assistant accurately reflects the device's actual state.
- A direct link to the WordClock Web Interface is available under the device details.
- Ensure the WordClock is reachable and the IP address is correct.
- Check the Home Assistant logs for any errors.
This project is licensed under the MIT License. See the LICENSE file for details.
- AWSW WordClock for making the WordClock 3D-Print files and software.
- https://github.com/bluenazgul/HA_AWSW_Wordclock | Forked project, initial inspiration!

