ChronoBell

ChronoBell is a compact LED clock with a bright, easy-to-read display, simple touch controls, a classic bell sound, and a handful of thoughtful extras that give it a distinctive character. It can show short local messages and guest WiFi details, and it includes several display styles and date views.

What makes it different

A bell that rings like a ship's clock - Traditional 1-8 strike pattern from nautical tradition, plus six other modes: off, single ding, hour count, half-hour, pair, and triple. You can hear each one in the menu before you choose it.

9 display styles + 5 date views - Big digits, a configurable INFO overlay, word clock, roman numerals, binary, bar graphs, drift, pong, or a configurable random view. INFO can show seconds, deciseconds, date, WDAY, or alternate between date and WDAY every N seconds after entering ALT. Drift uses the big digital layout, but lets displayed time slowly move away from real time and return. BAR turns hours, minutes, and optional seconds into stacked progress bars. Pong plays a live rally that scores the current time. Date views include day and month, year, moon phase, Western zodiac, and Chinese zodiac. Tap to peek at any view.

Local messages - Pulls short notices from any LAN device and shows them as brief previews. Choose font size, auto-dismiss timing, even bell strikes - all from the sender. Rendered by one general ChronoServe preview path.

Guest WiFi on screen - Shows the guest network name and password right on the clock. No phone needed. Good for lobbies, cafes, offices.

Set time manually or let it self-correct - It can set itself from WiFi and keep time on a battery-backed clock chip when offline. Or switch to manual mode and step through hour, minute, second, month, day, and year from the menu.

Two ways to configure - Tap the menu to change any setting on the device. Or press the BOOT button or flip HOTSPOT to ON in the menu to open the setup portal in your browser for WiFi, timezone, brightness - even firmware updates.

Three touch pads, no moving parts - Left, center, right. Tap to navigate, hold for the menu, hold longer for auto-repeat.

What you can do with it

Bell - Off, single ding, hour count, half-hour, pair, triple, or ship's bell. Hear a preview as you scroll.
Alarm - Set a wake-up time in OFF, ONCE, DAILY, WEEKDAY, or WEEKEND mode. Rings with a distinctive 1 2 3 2 1 bell pattern, repeats every 30s up to 10 times. Dismiss with a tap.
Timer - Use it as a stopwatch or a countdown timer. Countdown presets range from 1 to 90 minutes, and when time runs out the clock flashes 00:00, rings a 3-2-1 alert, and clears itself after 15 minutes.
Night mode - Dim the display, turn it off, mute the bell, or any combo - all on a schedule. Touch the clock to wake it for a minute.
Manual time - Switch from atomic (NTP + RTC) to manual and step through HH→MM→SS→Month→Day→Year. Persists across reboots.
Config portal - Scan WiFi networks, pick a timezone, tune display and bell settings, upload firmware - all from a browser.
New Year's Eve feature - On Dec 31 from 9 PM, tiny sparkles appear and grow more frequent. At 23:50 the countdown begins, at midnight the display cycles through "HAPPY NEW YEAR" with 12 bell strikes.
Local messages - Send one-shot messages from any machine using cli/chronosend. Attach bell strikes, pick font size, pipe from build tools. Router-side scripts can also post messages for domain expiry, backup status, etc.
Timekeeping - NTP syncs every 60 minutes when WiFi is available. The RTC keeps time when it's not. Manual mode bypasses both.
OTA updates - Push firmware over the air at chronobell.local.

Clock Styles

ChronoBell has nine clock display modes. The menu label is short because the screen is only 32x16 pixels:

Style	Menu	What it shows
Random	RND	Changes at the configured hour interval using BIG, INFO, WORD, ROMA, or BIN
Big	BIG	Large HH:MM digits, optimized for readability
Info	INFO	Time on top with a selectable second line
Word clock	WORD	A compact phrase-style clock such as "TWENTY TO THREE"
Roman	ROMA	Roman-numeral-style hours and minutes
Dial	DIAL	Minimal analog dial with optional cardinal marks and ellipse-scaled hands
Binary	BIN	Binary hour, minute, and second rows
Bar	BAR	Hour, minute, and optional second progress bars
Pong	PONG	A live rally where each player's score is the current time; miss sequence on every minute/hour change
Drift	DRIFT	BIG-style digits where displayed time slowly drifts and returns

Date Views

The DATE clock style and the standalone date screen use the same five date views:

Style	Menu	What it shows
Date	DATE	Weekday and month/day
Year	YEAR	Calendar year and day of year
Moon	MOON	Lunar phase state plus the next full/new moon countdown
Western zodiac	ZOD	Western zodiac sign plus element
Chinese zodiac	CZOD	Chinese zodiac animal plus element

Timer

The timer screen has two jobs:

Mode	What it does
Stopwatch	Counts up from zero until you stop it
Countdown	Counts down from a chosen preset, then alerts you when it reaches zero

Stopwatch and countdown both keep their state across reboots. The center button moves between the clock, date, guest WiFi, stopwatch, and countdown screens. On the countdown screen, the right button changes the preset and the left button starts or pauses the timer.

When a countdown finishes, ChronoBell shows a blinking 00:00, plays a short alert pattern, and stays on the countdown screen until you acknowledge it.

Local JSON Messages

ChronoBell polls a LAN HTTP endpoint for active messages. Any script or tool on your network can send them. Messages can be fire-and-forget (auto-dismiss, no lingering indicator), appear in a chosen font size, trigger bell strikes, and use one general preview renderer regardless of clock style.

Display timing is firmware-owned. The sender only supplies the message text and a small set of presentation flags; the firmware owns scroll completion and how long a preview stays on screen.

Default firmware config in Config.h:

#define CHRONOSERVE_ENABLED 1
#define CHRONOSERVE_URL "http://192.168.8.1/cgi-bin/chronoserve"
#define CHRONOSERVE_POLL_INTERVAL_SEC 10
#define CHRONOSERVE_MAX_MESSAGES 5

Display behavior

When a message preview is active, the firmware uses one general ChronoServe renderer for every source. Clock style does not change the routing.

Touch interaction per-message: a short press on center shows the next unread message; a long-press on center dismisses it. autoDismiss messages skip the unread queue entirely.

Message text is normalized: whitespace is collapsed, letters uppercased, accents folded to ASCII, unsupported characters replaced with spaces.

Font sizes

Mode	Value	Font	Height	Use case
small	0	small	5px	Compact notifications
medium	1 (default)	medium	10px	General messages
big	2	big	16px	Alerts and titles

Expected `?msg` response

{
  "device": "chronobell",
  "now": 1782580100,
  "messages": [
    {
      "id": "build-ok-1782580100",
      "source": "cli",
      "type": "notification",
      "priority": 5,
      "title": "MAKE",
      "body": "EXIT 0",
      "created": 1782580000,
      "expires": 0,
      "display": {
        "indicator": false,
        "dismissible": false,
        "autoDismiss": true,
        "mode": 1,
        "force": false,
        "bell": [3]
      }
    }
  ]
}

Display fields

Field	Type	Default	Description
`indicator`	bool	`true`	Show blinking unread dot
`dismissible`	bool	`true`	Allow user to dismiss via center long-press
`autoDismiss`	bool	`false`	Remove from queue after preview (no blinking dot)
`mode`	int	`1`	Font size: 0=small, 1=medium, 2=big
`force`	bool	`false`	Always full-screen, even in INFO style
`bell`	array	`[]`	Bell strike pattern, e.g. `[3]` or `[3,2,1]`

Expected ?wifi response:

{
  "device": "chronobell",
  "now": 1782580100,
  "guestwifi": {
    "ssid": "NEXO-GUEST",
    "password": "XKQPVJTHZNLD"
  }
}

Priority behavior:

Priority	Indicator burst speed	Automatic preview
0-4	2400ms period, count × blink, 1500ms pause	None unless center is tapped
5-6	2400ms period, count × blink, 1500ms pause	First calm preview
7-8	1200ms period, count × blink, 1500ms pause	Preview soon
9	200ms period, count × blink, 1500ms pause	Preview as soon as practical

The indicator blinks count times at the priority period, then pauses 1.5s before the next check. Preview duration is firmware-owned and does not depend on sender-side timing hints.

Router Message Endpoint

The cli/chronoserve script is a self-contained POSIX shell tool for GL.iNet/OpenWrt routers. Install it as /usr/bin/chronoserve and expose it as a CGI wrapper:

scp cli/chronoserve root@192.168.8.1:/usr/bin/chronoserve
ssh root@192.168.8.1 -- /usr/bin/chronoserve install

To use a custom CGI directory:

ssh root@192.168.8.1 -- /usr/bin/chronoserve install /custom/cgi/path

To reverse:

ssh root@192.168.8.1 -- /usr/bin/chronoserve uninstall

Test the endpoint:

/usr/bin/chronoserve add DOMAIN "AVAILABLE"
wget -qO- "http://192.168.8.1/cgi-bin/chronoserve?msg"
wget -qO- "http://192.168.8.1/cgi-bin/chronoserve?wifi"

chronoserve stores state under $BASE (default /etc/chronoserve/), including message files, the cached message payload, domain-check state, guest QR seed/config state, a cron lock, and dismissed IDs. State persists across reboots; the tool recreates missing directories on use.

Useful commands:

/usr/bin/chronoserve serve
/usr/bin/chronoserve serve --cgi
/usr/bin/chronoserve add DOMAIN "AVAILABLE"

/usr/bin/chronoserve add \
  --id domain-drop-comonoclaroquesi \
  --source domain-watch \
  --type alert \
  --priority 9 \
  --title DOMAIN \
  --body "AVAILABLE" \
  --ttl 86400 \
  --mode 2 \
  --force \
  --bell 3,2,1

/usr/bin/chronoserve clear domain-drop-comonoclaroquesi
/usr/bin/chronoserve list
/usr/bin/chronoserve rebuild
/usr/bin/chronoserve check-domain comonoclaroquesi.com
/usr/bin/chronoserve cron add check-domain comonoclaroquesi.com
/usr/bin/chronoserve cron remove check-domain

The CGI endpoint is query-driven:

?msg serves the cached message JSON and accepts dismiss=<id>
?wifi serves the guest WiFi JSON
?add creates a message using the same fields as chronoserve add
?clear&id=<id> clears a message, and ?clear&all=true clears all messages
?dismiss&id=<id> dismisses a message, and ?undismiss&id=<id> makes it visible again
?dismissed lists dismissed message IDs
?guestqr updates guest QR settings and optionally applies a new guest WiFi password
?check-domain&domain=<domain> runs the domain checker and publishes any resulting message

The write/control API accepts both query strings and application/x-www-form-urlencoded POST bodies. It is intended for trusted LAN scripts and is not authenticated, so do not expose the CGI endpoint to the public internet.

Examples:

curl -G "http://192.168.8.1/cgi-bin/chronoserve?add" \
  --data-urlencode title="BACKUP" \
  --data-urlencode body="DONE" \
  --data-urlencode priority=7 \
  --data-urlencode ttl=3600

curl -G "http://192.168.8.1/cgi-bin/chronoserve?clear" \
  --data-urlencode id="backup-1782580100"

curl -G "http://192.168.8.1/cgi-bin/chronoserve?guestqr" \
  --data-urlencode rotate=weekly \
  --data-urlencode ssid="NEXO-GUEST" \
  --data-urlencode length=12

curl -G "http://192.168.8.1/cgi-bin/chronoserve?check-domain" \
  --data-urlencode domain="comonoclaroquesi.com" \
  --data-urlencode force=true

?guestqr supports rotate, seed, ssid, section, length, alphabet, outdir, no-apply=true, and no-html=true. Without no-apply=true, it may update the router's live guest WiFi password.

?check-domain supports domain, optional id, and force=true. It runs WHOIS synchronously. ChronoBell polling with ?msg and ?wifi never runs WHOIS, curl, or wget, so a slow registrar or network error cannot block the display.

Domain checks run from cron or manually:

/usr/bin/chronoserve cron add check-domain comonoclaroquesi.com
/usr/bin/chronoserve check-domain comonoclaroquesi.com

The domain checker parses Domain Status: lines from WHOIS to classify the domain against all ICANN EPP status codes, with free-text fallbacks for registries that do not use EPP status lines. Network errors update state to ERROR.

EPP status(es)	State	Priority	Display	Behavior
WHOIS no-match	AVAILABLE	9	`DOMAIN / BUY NOW`	Immediate auto-preview, 200ms blinking dot
`pendingDelete`	PENDING_DELETE	7	`DOMAIN / PENDING DELETE`	Auto-preview after 5s, 1200ms blink
`pendingRestore`	PENDING_RESTORE	6	`DOMAIN / RESTORING`	Auto-preview after 1s
`serverHold`, `clientHold`	HOLD	6	`DOMAIN / HOLD`	Auto-preview after 1s
`redemptionPeriod`	REDEMPTION	5	`DOMAIN / REDEMPTION`	Auto-preview after 1s
`pendingTransfer`	PENDING_TRANSFER	5	`DOMAIN / TRANSFER`	Auto-preview after 1s
Ambiguous / unknown	CHECK	6	`DOMAIN / CHECK`	Auto-preview after 1s
`ok`, `inactive`, grace periods, client/server prohibitions	REGISTERED	—	silent	State tracked; no message

When redemptionPeriod appears together with pendingDelete, REDEMPTION takes precedence because the domain is still restorable. PENDING DELETE applies when pendingDelete appears alone; client/server prohibition codes do not override these lifecycle states.

Every status change produces an inbox-persistent message. The blinking unread dot appears on the clock face; tap center to recall the full-screen preview, hold center 1.5s to dismiss it permanently (the next status change will re-surface it). Registered domains, grace periods, and client/server lock codes are tracked silently. Dismissals expire after one year. When the domain state changes, any previously dismissed messages for that domain are automatically un-dismissed so the new status always alerts.

Manual tests:

rm -rf /etc/chronoserve
/usr/bin/chronoserve serve
/usr/bin/chronoserve add DOMAIN "AVAILABLE"
/usr/bin/chronoserve serve
/usr/bin/chronoserve clear <id>
/usr/bin/chronoserve add --ttl 1 TEST EXPIRE
sleep 2
/usr/bin/chronoserve rebuild
/usr/bin/chronoserve cron add check-domain comonoclaroquesi.com
grep chronoserve /etc/crontabs/root
/usr/bin/chronoserve cron remove check-domain

Troubleshooting starts with $BASE/chronoserve.log and $BASE/domain-state-<domain> (per-domain state files). Set CHRONOSERVE_BASE to change the state directory. If whois is not installed on the router, check-domain enters the safe ERROR state and does not create alerts.

chronosend — send messages from your laptop

cli/chronosend is a standalone POSIX shell script that sends one-shot messages to the chronoserve CGI endpoint. It mirrors all chronoserve add options and adds fire-and-forget defaults — no lingering indicator, no user dismiss needed.

Install

Copy cli/chronosend somewhere on your $PATH:

sudo cp cli/chronosend /usr/local/bin/chronosend
sudo chmod +x /usr/local/bin/chronosend

Usage

chronosend [options] <body>

Options

Option	Description
`CHRONOSERVE_URL`	CGI endpoint (default `http://192.168.8.1/cgi-bin/chronoserve`)
`--title <text>`	Optional header line shown above the body
`--mode <0\|1\|2>`	Font size: 0=small, 1=medium, 2=big (default `1`)
`--bell <pattern>`	Bell strikes, e.g. `3` or `3,2,1`
`--ttl <sec>`	Time-to-live (default `600`, max `86400`)
`--force`	Always full-screen, even in INFO style
`--no-auto-dismiss`	Keep message in queue after preview
`--dry-run`	Print the request instead of sending
`--debug`	Print MPD queries and outgoing request data

Examples

# Basic notification
chronosend MAKE "EXIT 0"

# Big full-screen alert with bell
chronosend --mode 2 --bell 3 "INTRUSION DETECTED"

# Pipe from a build
make 2>&1 | head -5 && chronosend MAKE "EXIT 0"

# Info-line notification (small font)
chronosend --mode 0 BACKUP "DONE"

# Dry-run to see what would be sent
chronosend --dry-run TEST "MESSAGE"

MPD mode

chronosend mpd watches MPD and posts now-playing messages using the same general ChronoServe preview path as custom messages.

chronosend mpd

It uses mpc to fetch the current song. On each song change it sends NOW PLAYING <track by artist>. While the same song continues, it sends <track by artist> again every repeat interval. MPD repetition is sender-owned: the firmware only sees new message revisions and renders each one once, while still letting scrolling titles complete a full pass from a blank screen back to a blank screen.

When playback stops, the watcher clears the message. TTL is still used as stale cleanup if the watcher exits or loses network before it can clear or refresh the message.

Configure via environment variables:

Env var	Default	Description
`CHRONOSEND_MPD_FORMAT`	`%title% BY %artist%`	`mpc current -f` format string
`CHRONOSEND_MPD_REPEAT_SEC`	`120`	Seconds between sender-owned repeated now-playing updates; `0` disables repeats
`CHRONOSEND_MPD_TTL_BUFFER`	`10`	Extra stale-cleanup seconds beyond the next expected update or song end
`CHRONOSEND_MPD_FALLBACK_TTL`	`300`	Maximum repeat window when MPD does not report a song duration

Or edit the header constants in cli/chronosend:

Constant	Default	Description
`DEFAULT_MPD_REPEAT_SEC`	`120`	Default repeat interval for MPD now-playing updates
`DEFAULT_MPD_TTL_BUFFER`	`10`	Extra seconds beyond song duration
`DEFAULT_MPD_FALLBACK_TTL`	`300`	Fallback lifetime when duration is unknown

Set env vars at runtime or in the systemd service:

CHRONOSEND_MPD_REPEAT_SEC=60 chronosend mpd

Install as a systemd user service:

chronosend install

This copies the script to ~/.local/bin/ and creates a user service at ~/.config/systemd/user/chronosend-mpd.service. Override any default via:

systemctl --user edit chronosend-mpd

[Service]
Environment=CHRONOSEND_MPD_REPEAT_SEC=60

Bell Modes

The bell can be off, simple, clock-like, or nautical. Scroll through BELL in the menu to hear a live preview before saving.

Mode	Menu	What it does
Off	OFF	No scheduled bell
Single ding	DING	One strike on the hour only
Hour count	HOUR	Rings the 12-hour count on the hour, from 1 to 12 strikes
Half-hour	HALF	Rings the hour count on the hour, plus one strike at :30
Pair	PAIR	Rings the hour count in groups of two with a short pause between pairs
Triple	TRIP	Rings the hour count in groups of three with a short pause between groups
Ship's bell	SHIP	Traditional ship's clock pattern: 1 to 8 strikes across the four-hour watches, with the half-hour counted in the sequence

Timer alerts are separate from scheduled bell modes: when a countdown expires, ChronoBell plays its alert pattern even if the display is not in a clock style.

Getting Started

Build and upload

# PlatformIO - serial (USB)
pio run -e esp32dev --target upload

# PlatformIO - OTA (wireless, password in platformio.ini)
pio run -e esp32dev-ota --target upload

# Arduino CLI
arduino-cli compile --fqbn esp32:esp32:esp32
arduino-cli upload --fqbn esp32:esp32:esp32

First boot

Upload the firmware to your ESP32.
Connect to the ChronoBell WiFi access point and open http://192.168.4.1.
Scan for your network, enter the password, pick your timezone, and save.

The clock reboots, connects to WiFi, syncs time, and starts running.

Reopen the config portal

Press the BOOT button or toggle HOTSPOT to ON in the menu.

Touch Controls

Gesture	Pad	What it does
Tap	Left	Previous menu item / previous display style / stopwatch start-stop / acknowledge expired countdown and stay on Countdown
Tap	Center	Confirm a menu choice / cycle views (Clock → Date → Guest WiFi → Stopwatch → Countdown) / acknowledge timer alert (returns to Clock only if the alert came from Clock)
Tap	Right	Next menu item / next display style / cycle countdown preset
Hold 1.5s	Center	Enter the menu
Hold (auto-repeat)	Left or Right	Scroll fast through menu items or countdown presets
Hold 5s	Left	Force a full MAX7219 display driver reset (recovers from transient glitches)
Hold 5s	Right	Reboot the ESP32

When night mode turns the display off, any touch wakes it for a minute.

Item	Choices	What it sets
STYLE	RND / BIG / INFO / WORD / ROMA / DIAL / BAR / BIN / PONG / DRIFT	Clock style; drift is the mode that makes now feel less fixed
ANIM	OFF / ON	Enable or disable clock transitions
INFO	SEC / DECI / DATE / WDAY / ALT	Second-line choice for the INFO style
DATE	DATE / YEAR / MOON / ZOD / CZOD	Extra info shown in the date view
FORMAT	24H / 12H	24-hour or AM/PM
NIGHT	OFF / LOW / LOWM / DARK / DRKM / MUTE	Dim, mute, or turn off the display and bell on a schedule
BRIGHT	0-15	How bright the LEDs shine
BELL	OFF / DING / HOUR / HALF / PAIR / TRIP / SHIP	Scheduled bell/chime mode (scroll to hear a preview)
SECOND	OFF / ON	Show the seconds bars in BAR mode
SETTIME	AUTO / MANUAL	Time source - automatic (NTP + RTC) or manual entry
HOTSPOT	OFF / ON	Turn the web config portal on or off

Hold center to enter the menu, left/right to browse, and tap center to edit. Each confirm saves the current step immediately. STYLE has a second step for clocks with configurable details: BIG, INFO, and DRIFT offer separator choices, DIAL offers MARKS OFF or ON, BAR offers the SECOND toggle for optional seconds bars, and BIN offers a SECOND toggle for binary seconds. INFO first opens a second-line chooser labeled INFO, then the separator step labeled COLON. Each style remembers its own choice. ANIM toggles between OFF and ON. When ON, animations transition smoothly between views (e.g., digit morphs, screen retune effect) as long as the engine is compiled in. WORD, ROMA, PONG, and RND save immediately because they do not expose a second step. SETTIME also saves each confirmed step, so aborting mid-flow keeps the already confirmed values.

Setting the time manually

When you pick MANUAL, the clock reads the current time and lets you step through six edits:

HOUR (0-23)
MIN (0-59)
SEC (0-59)
MONTH (1-12, shown as a name like JAN)
DATE (1-31)
YEAR (2024-2035)

Tap center to advance each step. On the last step, the clock saves the new time to the RTC and remembers it across reboots.

Hardware

Part	What it is
Brain	ESP32
Display	8x MAX7219 8x8 LED modules (32 columns x 16 rows)
RTC	DS1307 or DS3231 (battery-backed, keeps time when power is off)
Touch	CAP1188 capacitive controller, 3 pads (left / center / right)
Bell	Driven by GPIO 13 (active-high)
Boot button	GPIO 0 - short press opens the config portal

Pin map

Signal	GPIO
MAX7219 chip-select	5
MAX7219 SPI clock	18
MAX7219 SPI data	default MOSI
I2C data	22
I2C clock	21
Bell output	13
Boot button	0

A few things you can tune

Open Config.h to adjust these:

Constant	Default	What it does
`DISPLAY_FLIP`	`0`	Set to `1` if your display is mounted upside-down
`CAP1188_TOUCH_THRESHOLD`	`0x35`	Touch sensitivity - lower numbers trip more easily
`NIGHT_DIM_START_HOUR`	`18` (6 PM)	When night dimming starts
`GUEST_WIFI_ENABLED`	`1`	Set to `0` to compile guest WiFi out
`CHRONOSERVE_URL`	`http://192.168.8.1/cgi-bin/chronoserve`	Base CGI endpoint; append `?msg` or `?wifi`
`CHRONOSERVE_POLL_INTERVAL_SEC`	`60`	Message poll interval in seconds
`CHRONOSERVE_MIN_DURATION_SEC`	`10`	Minimum preview lifetime; scrolling extends beyond this as needed
`CHRONOSERVE_SCROLL_STEP_MS`	`140`	Firmware scroll animation ms/pixel
`CHRONOSERVE_MIN_SCROLL_CYCLES`	`1`	Minimum complete scroll passes before firmware may time out
`TIME_SYNC_INTERVAL_MINUTES`	`60`	How often NTP re-syncs
`RND_STYLE_INTERVAL_MINUTES`	`360`	RND change interval aligned to local midnight (`360` = 00:00, 06:00, 12:00...; valid 1-1440)
`HOTSPOT_TIMEOUT_MINUTES`	`0`	Auto-stop hotspot after N minutes (`0` = stays on)
`DIGIT_TRANSITIONS`	`1`	Set to `0` to remove per-digit morph engine (saves flash/RAM)
`SCREEN_TRANSITION`	`1`	Set to `0` to remove screen retune engine (saves flash/RAM)
`BAR_HOUR_TOP_Y`	`1`	Top row for BAR hour bars
`BAR_ALIGNMENT`	`0`	`0` keeps the current BAR layout, `1` centers the bar layout
`BAR_HOUR_THICKNESS_NO_SECONDS`	`5`	Hour bar thickness in BAR mode when seconds are hidden
`BAR_HOUR_THICKNESS_WITH_SECONDS`	`5`	Hour bar thickness in BAR mode when seconds are shown
`BAR_MINUTE_TOP_Y_NO_SECONDS`	`11`	Top row for BAR minute bars when seconds are hidden
`BAR_MINUTE_TOP_Y_WITH_SECONDS`	`8`	Top row for BAR minute bars when seconds are shown
`BAR_SECOND_TOP_Y`	`12`	Top row for BAR seconds bars
`DRIFT_MAX_OFFSET_MINUTES`	`8`	Maximum distance from real time in either direction
`DRIFT_PATTERN`	`0`	0=behind↔ahead, 1=real→behind→real, 2=real→ahead→real
`DRIFT_TIME_TO_MAX_OFFSET_MINUTES`	`60`	Minutes from real time to maximum offset; pattern 0 takes twice this between extremes
`FEATURE_NEW_YEAR`	`1`	Set to `0` to remove the entire NYE sequence (saves ~2KB flash)

OTA Updates

Once the clock is on your network, push firmware wirelessly:

pio run -e esp32dev-ota --target upload

The OTA environment (esp32dev-ota) in platformio.ini uses espota protocol with the password chronobell.

You can also upload a .bin file through the web config portal (http://chronobell.local) - no cables needed.

Name		Name	Last commit message	Last commit date
cli		cli
imgs		imgs
src		src
.gitignore		.gitignore
Config.h		Config.h
README.md		README.md
build_opt.h		build_opt.h
chronobell.ino		chronobell.ino
chronobell.png		chronobell.png
chronoportal.png		chronoportal.png
platformio.ini		platformio.ini
sdkconfig.defaults		sdkconfig.defaults

Navigation Menu

Repository files navigation

ChronoBell

What makes it different

What you can do with it

Clock Styles

Date Views

Timer

Local JSON Messages

Display behavior

Font sizes

Expected `?msg` response

Display fields

Router Message Endpoint

chronosend — send messages from your laptop

Install

Usage

Options

Examples

MPD mode

Bell Modes

Getting Started

Build and upload

First boot

Reopen the config portal

Touch Controls

Menu

Setting the time manually

Hardware

Pin map

A few things you can tune

OTA Updates

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

ChronoBell

What makes it different

What you can do with it

Clock Styles

Date Views

Timer

Local JSON Messages

Display behavior

Font sizes

Expected ?msg response

Display fields

Router Message Endpoint

chronosend — send messages from your laptop

Install

Usage

Options

Examples

MPD mode

Bell Modes

Getting Started

Build and upload

First boot

Reopen the config portal

Touch Controls

Menu

Setting the time manually

Hardware

Pin map

A few things you can tune

OTA Updates

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Expected `?msg` response