OpenHamClock
The real steps used to get OpenHamClock running as a dedicated local kiosk display — see the HamClock to OpenHamClock writeup for the backstory on why.
Here’s the original X post on setting it up, along with the discussion that followed: https://x.com/mwfoutch1/status/2038314358200046059
Prerequisite: Linux
This assumes a working Linux install already in place. Starting from an old or underpowered laptop instead? See the Linux Setup guide first.
Install (Linux, systemd service)
curl -fsSL https://raw.githubusercontent.com/accius/openhamclock/main/scripts/setup-linux.sh | bash -s -- --service
cd ~/openhamclock
cp .env.example .env && nano .env
Add your CALLSIGN and LOCATOR in .env, then:
sudo systemctl restart openhamclock
Open http://localhost:3000 in Firefox, and hit F11 for instant full-screen — or run npm run electron for a native app feel instead of a browser tab.
Why Local Instead of the Hosted Site
OpenHamClock also runs instantly at openhamclock.com — no install needed, great for a quick look. A local install is worth the extra step for:
- A true dedicated full-screen kiosk display that auto-starts on boot
- Faster, smoother performance with zero web lag
- Better privacy and security — runs only on localhost
- A display that keeps working even if the public site is slow or down
- Full customization and control
Real-World Notes
- Views best on a larger screen — there’s a lot going on with the display.
- With everything enabled, it’s a real load on an old repurposed laptop. Worth trying the full feature set first before turning anything off.
If this helps you, check out my adblob to support the work.