ZL4ST HamClock Modern (Python)

Modern Python implementation of ZL4ST HamClock - a kiosk-style application for amateur radio operators.

Disclaimer:

I have nothing against the original hamclock, what they have done with it is amazing, and a good starting point. However I quickly reached limits of what I wanted to do, wanted to add modules, size adjustments, cleaner layout etc. So I took the concept and created my own for what I wanted.

This is a personal project, I have built it for my needs, but also designed it for ease of use for others. Once its working how I want, support will be limited. However requests, bugs, etc, I will do my best to sort out.

This was heavily assisted with AI If you don't like this, please dont bring your oppinions into this. While I know programming, and could have likely figured out how to do this on my own, it would have taken months if not years of tinkering away at it Instead, I used AI to assist with quick development, advanced features, etc.

Documentation

• USER_GUIDE.md – How to use: first run, setup, keyboard shortcuts (S = Setup, L = Layout), layout editor, map center (Maidenhead or lat,lng), map and clock module options, and configuration.

Requirements

• Python 3.8 or higher
• See requirements.txt for dependencies

Note: For desktop mode, PyQt5 and PyQtWebEngine are required. They are included in requirements.txt.

Features

• Desktop app for local use

• Server only version with web based access

• Read only mode for 'public' displays

• Works with any size monitor, dynamic scaling

• Choose your grid layout, no set grid size

• Choose which modules go where, no fixed layout

• Resize modules, have some small and some large

• Clock with Local, UTC, and International Time

• Map with various base images

Feature requests

A list of requested features is in docs/FEATURE_REQUESTS.md. If you want to request a feature, raise a "Issue" and I will review it