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

Receive the SZ1A AWARD online with six unique QSOs

In 2016, the idea of the award was born during a meal and discussion, as is usually the case. Following a decision of the Board of Directors, the Radio Amateur Association of Western Greece began […]

Learn More

Make your own propagation forecast with W6EL

Written by Kostas Stamatis, SV1DPI Carl Luetzelschwab, K9LA back in 2004, wrote an article called “An Introductory Tutorial to W6ELProp – Running Your Own Propagation Predictions”. This file helped me a lot to understand how […]

Learn More
The team that participated in CQ WW SSB 2019 with operators SV1DKD, SV1PMQ, SV8PMM, SV1QXU, SV1CIB, SV1CQN, SV1HKH, SV2HQL, SV4QNP and SV1GE

2019 CQ World Wide DX Contest SSB – The results are in!

The official results of the 2019 CQ WW DX Contest SSB have been published. We competed in the most demanding category, the multi-operator single-transmitter high power (MS HP) category. CQ WW SSB is the world’s […]

Learn More

Leave a Reply