HamClock Launcher

A GUI launcher for HamClock on Macs

HamClock versions are included - no other installation required

HamClock Launcher Screenshot

Download v0.2

Download for Apple Silicon (M series) Download for Intel Macs
Note: Choose the version that matches your Mac's processor. Not sure which one? Click the Apple menu → About This Mac to check your processor type.

Overview

HamClock Launcher is a cross-platform desktop application that simplifies launching and managing HamClock instances. It captures and displays HamClock's output in real-time, making it easy to monitor the application's status and debug any issues.

Features

📺 Multiple Resolutions

Choose from 800x480, 1600x960, 2400x1440, or 3200x1920

📊 Real-time Monitoring

View HamClock's output as it runs

🌐 Browser Integration

One-click browser launch

🔒 Safe Shutdown

Prompts before closing if running

📋 Output Management

Copy, select all, and auto-limiting

📚 Help Resources

Quick access to user guide

Requirements

Installation

Using the DMG Installer (Recommended for macOS)

  1. Download the appropriate DMG file for your Mac (see download buttons above)
  2. Open the DMG file
  3. Drag HamClockLauncher to your Applications folder
  4. Launch the application - HamClock binaries are already included!
✨ DMG files include all HamClock binaries - No additional downloads needed! The DMG installer includes all four HamClock versions (800x480, 1600x960, 2400x1440, and 3200x1920) ready to use.

Usage

  1. Launch the Application: Open HamClockLauncher from your Applications folder (or run the Python script)
  2. Select HamClock Version: Choose your preferred display resolution from the radio buttons
  3. Start HamClock: Click "Start HamClock" button
  4. Open in Browser: Click "Open in Browser" to view HamClock at http://localhost:8081/live.html
  5. Stop HamClock: Click "Stop HamClock" when finished

Menu Options

Edit Menu

Help Menu

Known Issues

macOS TSM Warnings

When launching HamClock on macOS, you may see warnings like:

TSMSendMessageToUIServer: CFMessagePortSendRequest FAILED(-1) to send to port com.apple.tsm.uiserver

These warnings are harmless and related to macOS's Text Services Manager. They do not affect HamClock's functionality and can be safely ignored.

Mac airport command missing or deprecated

On newer version of macos, the airport command is missing or deprecated. This command is used be HamClock to get the WiFi signal strength. These messages are informational, and HamClock does not report WifI signal strength in its display. The messages look like :

sh: / System/Library/PrivateFrameworks/Apple80211.framework/Versions/Current/Resources/airport: No such file or directory

I am working on a workaround or fix. HamClock still works fine, but will not report WiFi signal strength in the console.

License

This project is licensed under the MIT License.

Copyright (c) 2025 Hubert Hickman

About HamClock

HamClock is developed by Elwood Downey and is available at:
https://www.clearskyinstitute.com/ham/HamClock/

HamClock is licensed under the MIT License.

Author

Hubert Hickman
Email: hubert.hickman@gmail.com

View on GitHub →