Quickstart

Getting started with your word-o-clock in a few simple steps.
Tags:

First Power-Up

web ui

When you start your Word-o-Clock for the first time, follow these steps to get started:

  1. Power Connection

    • Connect your Word-o-Clock to a power source using a USB-C cable
    • Use a modern, PD-capable USB charger (5V/2A recommended)

  2. WiFi Setup

    • The clock will create its own WiFi network named word-o-clock
    • Connect to this network using the password: w0Rd0Cl0cK
    • Open a web browser and navigate to 192.168.4.1
    • You’ll see the WiFi setup page where you can enter your home network credentials
    • After saving, the clock will restart and connect to your local network

Accessing the Web Interface

Once connected to your network:

  1. Find your Word-o-Clock’s IP address by:
    • Checking your router’s DHCP client list
    • Using network discovery tools
    • Looking for a device starting with “woc_<random_id>”
  2. Open that IP address in your web browser

Basic Configuration

Navigation Overview

The web interface is organized into pages for different functions:

  1. Available Pages

    • Light (/ and /light): Control state, brightness, color, and auto-brightness
    • Time (/time): Set time manually, daily light schedule, and NTP settings
    • System (/system): Configure MQTT, clockface, and system settings
    • Firmware Update (/update): Accessible via System → Update

  2. Dark Mode

    • Light/Dark Mode toggle in the header

Saving Changes

Save Settings

  • Toggle switches set to off typically take effect immediately
  • When turning a switch on, additional parameters might be required before saving to apply the changes.
  • Some changes may restart the device

Pages

Light Settings

Light Page Overview The Light page lets you control the appearance of your word clock:

  1. Basic Controls

    • On/Off toggle for the entire LED matrix
    • Color picker for selecting any RGB color
    • Brightness slider (0-255), which is only available when Auto Brightness is disabled.

  2. Auto-brightness

    • Toggle to enable/disable
    • Uses built-in light sensor to automatically adjusts brightness based on ambient light

Time Configuration

Time Page Overview Configure how your Word-o-Clock keeps time:

  1. Manual Time Setting

    • Set the current time manually if needed
    • Uses 24-hour format
    • Syncs with internal RTC
    • does not turn off NTP, if you want to keep your manual time turn off the ntp feature as well!

  2. Light Schedule

    • Set daily on/off times
    • Uses 24-hour format
    • a schedule is only triggered by the start time, so creating a schedule in its scheduled time will not run schedule before the next day

  3. NTP Configuration

    • Server: Default is pool.ntp.org
    • Timezone selection from dropdown, default is Etc/UTC
    • Update interval (in minutes)
    • the system uses 1.pool.ntp.org and 2.pool.ntp.org as hard-coded backup servers

System Configuration

System Page Overview Advanced configuration options:

  1. MQTT Integration

    • Enable/disable Home Assistant integration
    • Broker settings:
      • IP address or hostname
      • Port, default is woc
      • Optional username/password
      • Topic prefix, default is woc
    • Auto-discovers in Home Assistant via Home Assistant MQTT integration

  2. Clock Face Options

    • Choose clockface format or language
    • Toggle between standard/regional time format
    • Currently supports German 11x11 layout, more clockfaces can be added

  3. System Maintenance

    • Link to firmware update web interface
    • Factory reset option

Troubleshooting

see Troubleshooting section