How-To Install Hamclock on Ubuntu 20

Hamclock is a handy application able to show:

  • accurate time,
  • world map & time zone,
  • solar activity,
  • sunrise and sunset times (grey line),
  • DX Cluster Spots, Beam heading & Maidenhead Grid Locators,
  • Northern California DX Foundation (NCDXF) beacons,
  • RSS feeds & news headlines and
  • other useful information.

The application was developed by Elwood Downey WB0OEW.


This guide assumes that you know how to install Ubuntu desktop. The ubuntu installation guide is available at

I propose that you select “minimal installation” to avoid occupying space with not-needed applications.

Note that in this guide all commands that are to be executed on the command line (terminal window) will be specially formatted. For example:

sudo apt update
Ubuntu Installation
  • Open a terminal window and install the latest updates.
sudo apt update
Updating software packages with apt update
  • Next, let’s install the additional required packages (prerequisites) that are needed for Hamclock to be installed.
sudo apt install curl make g++ xorg-dev
Installation of additional packages that are prerequisites for Hamclock
  • Now, we will install Hamclock on the user’s desktop.
  • Change Directory to the user Desktop.
cd ~/Desktop
  • Download the Hamclock source archive (zip file).
Download the Hamclock application with wget (zip file)
  • Unzip the source archive (zip file)
Unzip the zip file
  • Change Directory to the source directory (where the files were previously unzipped)
cd ESPHamClock
Enter the directory that contain the unzipped source files
  • We now need to build the executable file by selecting one of the supported sizes. According to the documentation the supported resolutions are: 800 x 480, 1600 x 960, 2400 x 1440, 3200 x 1920. If the display is larger, HamClock will center itself within a black background. Below we will create the executable for a screen resolution of 800 x 480
make -j 4 hamclock-800x480
Using ‘make’ we compile Hamclock into an executable file, with the screen resolution settings we want
  • We are now ready to run the application
sudo ./hamclock-800x480
Run Hamclock
  • Configuration Settings Page 1:
  • After starting the application, click anywhere on the screen to configure it.
  • Configuration Settings Page 2:
  • Click on page 1 to configure the cluster node and other settings (if you do not have a mouse, you can use the TAB key to move between the fields and the space key to change the values).
  • On page 2 setup any dxspider cluster node that you wish to connect to.
  • When done with the settings do not forget to press the Done button to save the configuration.

How to Autostart Hamclock on Ubuntu 20x

In order to autostart the application follow the steps below:

  • Edit sudoers and allow your user to execute any command without a password.
  • Open a terminal and run “sudo visudo” (omit the double quotes)
sudo visudo
Run “sudo visudo
  • Go to the bottom of the file and add the following line
yourusername	ALL=NOPASSWD: ALL
modifying sudoers
  • Press Ctrl + X and answer YES to save the file
  • Add HamClock to StartUp Applications
  • Click on the show application button (bottom left)
  • Type start
  • Click on Startup Applications
  • Click the Add button
  • Enter the information as shown below (replace /home/bill with your username’s home folder), assuming that you have installed Hamclock on the user’s Desktop as shown in this guide
  • Click the Add button.
  • Restart Ubuntu and test.

Disabling Blank Screen and Screen Lock

  • Open Settings
  • Go to Power and under Blank Screen select the option ‘never‘.
  • Go to Privacy.
  • Modify the settings to disable Blank Screen

The SZ1A Contest Station HamClock installed on a Full HD overhead display

Related articles

SZ1A sets New Own Record in CQ WW DX 2023 SSB

Team SZ1A Successfully Brakes Own All-Time Record in CQ WW SSB 2023

The excitement echoed throughout the team as the highly anticipated results of the CQ World Wide DX SSB 2023 Contest were unveiled. Our renowned station SZ1A, claimed an impressive array of accolades in the Multi-Single […]

Learn More
Project Vedema SX9V Remote Off Grid Ham Radio

Project Vedema SX9V – Remote Off-Grid Ham Radio Station (video)

SX9V Remote station description, automation and operation Background In recent years, on the one hand, the increased noise floor in cities, especially on the low bands, and on the other hand, the limited space for […]

Learn More

Yuri VE2IM from Zone 2 in CQ WW CW 2021

Written by Yuri Onipko – VE3DZ – VE2IM This time due to work commitments I just couldn’t allow myself to be off the grid for 3-4 days while driving to Zone 2 (which would be […]

Learn More

Leave a Reply