Corrections:

• There is a typo in Table 1. The RA8875 costs $35, not $5.
• There is a typo in Figure 2. The 33K resistor should be 330K.
• You should always install this resistor, whether or not you use the photocell.
• Also in Figure 2, sometimes pin A0 is labeled ADC.

• new: support up to 2 BME280 on same I2C bus at addresses 76 and/or 77
• new: display roving mouse coordinates over map (not ESP)
• new: tap hours in digital Big Clock to toggle 12 or 24 hour format
• change: RPi output pin 38 cycles at 1/2 Hz before sat rises
• change: set_displayTimes and get_config updated for daily on/off settings
• fixed: Kp plot min y was not clamped to 0
• fixed: don't reject NTP sites that respond in < 1 ms
• fixed: corrected time zone along the coast near Barcelona Spain
• fixed: on/off times table was not always initialized properly

• new: on/off times can be set for each day of the week in Setup page 3
• new: options to show day and date with Big Clock
• new: optional digital version of Big Clock
• changed: move plot titles across the top and improve labels
• changed: GUI cursor is now red and disappears when inactive (same as old fb0)
• changed: Big Clock sec hand jumps to each second like a battery clock
• fixed: Stopwatch and Big Clock honor brightness controls
• fixed: get_spacewx.txt output botched if Space_Wx never assigned to a pane
• fixed: removed option to turn off GUI Cursor -- replaced by disappearing cursor
• fixed: fullscreen could incorrectly default to yes
• fixed: set_newdegrid web command required extra trailing space

• new: add optional date and DE weather to Big Clock
• new: add Solar Wind option -- useful for predicting auroras
• new: setting RPi input pin 40 low temporarily replaces call text with ON THE AIR
• new: RPi output pin 38 is driven hi for 1 minute before satellite rise or set
• new: add set_title web command to temporarily set call text and colors
• change: add NOAA space weather and Solar Wind to get_spacewx.txt web command
• fixed: blinking symbols when at left edge of map
• fixed: gpsd could be sent very fast repetitive queries

• new: tap near pane top to direcly select any choice from popup menu
• new: added SDO 193 A image which shows coronal holes better
• new: added full screen GUI option in Setup page 4 -- fb0 is now legacy only
• new: added get_spacewx.txt web command
• change: Big Clock warns if UTC is offset or time source is not updating
• change: RPi stdout messages now go to file $HOME/.hamclock/diagnostic-log.txt
• change: RPi installation instructions now use /usr/local/bin -- see Desktop tab
• fixed: misc Big Clock issues

• new: full-screen analog Big Clock, available from within Stopwatch page
• new: added Skip buttons to ESP touch calibration page and while seeking best NTP
• new: support for running set-uid root as any file name or symlink (see FAQ)
• change: AZM button now says AZM or MER instead of always AZM with opposite b/w
• change: more set_stopwatch web commands
• change: use /dev/gpiomem instead of /dev/mem for RPi GPIO access
• change: put small deadband around VOACAP power touch area
• fixed: better RPi error messages if self-update or VOACAP fails
• fixed: stopwatch page honors idle timer and follows photocell

• new: added map label option, "GRD", to mark maidenhead grid squares around edge
• new: added Setup page 3 to adjust satellite footprint and path colors
• change: replace Moon pane distance with time of next rise or set
• change: web server now uses port 8080 to eliminate that reason to run as root
• change: changed web stopwatch commands, see FAQ for details
• fixed: Moon image was not always updated on time
• fixed: map download would cause infinite loop if local file save failed
• fixed: On/Off brightness timers not always ignored when set equal
• fixed: require gpsd TPV class record

• new: display Moon phase and DE info in any pane
• new: web server command set_voacap to set map
• change: SSN and Solar flux now show 30 day history
• fixed: reduced jaggies on larger screen sizes
• fixed: better performance under peak server loads

• new: global VOACAP maps; select by tapping desired band number in VOACAP pane
• new: can now specify a specific NTP server in Setup
• new: plot pane 3 can now show persistent live local DX weather
• new: Setup Page 2 option to disable all GPIO access for RPi and ESP
• new: web commands get_* and set_touch now also work in some auxiliary pages
• new: changes in next version are listed on remote update page
• new: tap DX symbol in DX pane to repeat info for same DX position
• change: look for BME280 sensor at either I2C address 0x76 or 0x77
• change: dx spot setup map option can be set to none, full call or just prefix
• change: add "Are you sure?" and Exit choice to RPi fb0 shutdown menu
• change: add more international NTP servers to internal list and always use fastest
• fixed: dx spot heading parser could mistakenly find unit label within QTH name

• new: plot pane 1 can now show persistent live DE local weather
• new: setup option to set whether dx spots are plotted on map
• changed: use slashed-zero in DE call sign if applicable
• changed: plot just the dx cluster spot prefix on map, not the entire call sign
• changed: accept 63 character WPA-2 passwords (previous limit was 31)
• fixed: record BME env sensor readings even when not being displayed
• fixed: rare gpsd connection issue

• new: two map styles now available, Terrain and Countries; select in Setup
• new: NOAA Space Weather RSG scales now available in the right plot pane
• new: add support for JTDX FT8 as a "cluster" similar to WSJT-X
• new: DX Cluster spots are displayed on map in addition to being listed
• new: can now tap to stop Satellite listing any time to avoid waiting for all entries
• new: report gpsd results on network startup summary page
• new: add new option to log usage to guide further development; default is no
• new: add progress bar during remote updates
• new: add more plot pane position assignment choices
• new: add web commands get_config, get_dxspots and set_pane (see FAQ)
• new: add range, rate and doppler shifts to web command get_satellite
• changed: remove set_dxclusterOnOff web command (use new set_pane instead)
• changed: move RPi configuration files to ~/.hamclock directory
• changed: add .txt extension to all web get_* commands not otherwise specified
• fixed: remove date flicker when changing DE pane to Analog clock format
• fixed: ignore occulted DE controls when pane is in Analog or Calendar format
• fixed: remove bell characters from dx cluster log
• fixed: remove symbol flicker at far right of X11 display
• fixed: retain setup gpsd and dx host names even when disabled
• fixed: inform dx cluster of new grid/lat/long if move DE
• fixed: allow for slow RPi WiFi connection when starting via crontab @reboot
• fixed: rare case of photosensor bar graph drawing out of bounds
• fixed: changed Yukon Territories timezone from UTC-8 to UTC-7

• new: can now connect to WSJT-X to automatically set DX to FT8 station worked
• new: add direct brightness control on ESP and RPi with DSI fb0
• changed: add idle time to set_displayTimes web command
• fixed: added better guard gap around time zone buttons
• fixed: HTTP response from get_satellite was malformed when no sat defined
• fixed: improved RPi GUI performance

• new: add Reboot option to cancel page (Pi fb0 only)
• changed: DE and DX DST buttons now cycle timezone -1/0/+1
• fixed: stale Idle could prevent clock On timer from restoring screen
• fixed: get_capture.bmp could give black image from X11 desktops
• fixed: improve response time from some RPi input devices
• fixed: one more DE Calendar update bug

• new: added more RESTful web commands, see FAQ
• new: min and max brightness in Setup
• new: idle timeout clock timer
• fixed: DE calendar update interval

• changed: always fall back to NTP if gpsd ever fails (not just initially)
• changed: 10 seconds touch and Setup opportunity (5 previously)
• changed: allow connecting to DX port numbers down to 23 (1000 previously)
• fixed: allow full length dx cluster host name in Setup
• fixed: better detection whether cluster is really a Spider
• fixed: DE and DX were not properly updated when modifying UTC in certain ways

• new: added a count down timer in Stopwatch, handy as 10 minute ID timer
• new: allow Kp to be positioned in right pane
• new: added more RESTful web commands, see FAQ
• new: added pressure calibration offset to Setup, handy for correcting station to sea level
• new: show project URL on Update page as reminder how to review changes before deciding
• changed: brighter lat/long 0/0 lines
• changed: slightly sharper twilight edge -- better match to actual photos
• fixed: UTC button was unresponsive if wifi connected late
• fixed: Setup page was not accepting keyboard Enter for Done
• fixed: support web commands from more browsers
• fixed: more efficient RSS
• fixed: Setup count down was cut off in RPi fb0

• new: gpsd now also sets time, useful if no NTP
• new: tap lower left corner of VOACAP pane to cycle power 1-10-100-1000 watts
• changed: added several KX3 cleanup commands before setting frequency
• changed: WiFi Setup on RPi uses wpa_supplicant.conf if present
• changed: add ellipsis to Setup Page prompt to emphasize tapping will change page
• changed: replace satellite CUBESAT XI-V with AO-27
• fixed: better error message if wx lookup fails
• fixed: removed occasional stray pixels when deleting a character in Setup
• fixed: DE calendar now rolls at local midnight, not UTC midnight

• new: gpsd now supported on all Clock architectures and host is settable in Setup
• new: DE calendar option, tap DE: to cycle formats
• new: Setup field to set BME temperature correction value
• new: Setup field to set KX3 baudrate to 4800 or 38400
• change: Setup is now two pages with more options
• change: replace satellites AAUSAT-II, ITUPSAT1, KISEKI and SRMSAT with Huskysat, NO-103, NO-104 and RS-44

• new: set Elecraft KX3 to DX Cluster Spot frequency; see FAQ for details
• new: display current version number in red if newer version is available
• changed: UTC button label says "OFF" when Clock time is not UTC
• fixed: better algorithm to find RPi IP address
• fixed: better keyboard tab support in RPi Setup
• fixed: larger RPi fb0 cursor on 7-9" displays

• new: holding padlock for 3 seconds gives offer to shutdown RPi if using fb0
• changed: UTC button label says "NOT" and color is red when time is not UTC
• fixed: wrong units in BME280 temperature change in V 2.41 (change was too large)
• fixed: time skew between exiting and reentering stopwatch

• changed: improved refraction model for satellite passes; especially improves Moon rise/set times
• fixed: occasional double sat path after erasing NCDFX beacons

• new: support Moon as a satellite for EME
• changed: sat times now use h separator (instead of colon) if more than hour
• changed: red fb0 cursor
• changed: GOES 15 has been decommissioned, use GOES 16 for XRay flux
• changed: tweak BME280 temperature reading algorithm
• fixed: time zone near Long Island, NY

• new: added simultaneous mouse support for RPi DSI 7" touch screen
• new: added RPi keyboard hot plug

• new: support for RPi DSI 7" touch screen
• new: stopwatch color control
• fixed: better RPi/UNIX cpu load management
• fixed: small error in ESP LLG lines
• changed: remove donoff

• new: support local gpsd for GPS location devices on RPi or other UNIX
• new: Setup allows entering fractional DE lat and long
• new: add Skip buttons to Setup and WiFi screens
• changed: increase tap HOLD time from 1000 to 1500 ms
• fixed: more reliable RPi fb0 display on/off method
• fixed: ESP screen flip

• fixed: ESP Setup prompts

• fixed: eliminate RPi fb0 cursor flicker
• fixed: RPi unable to control HDMI on/off when started from certain crontab entries
• fixed: Santa could reboot ESP in certain situations

• new: track Santa on Dec 24
• new: RPi WiFi setup
• changed: redesigned Setup screen

• changed: 5x more efficient RSS handling
• fixed: time could be several seconds off when started via crontab
• fixed: UTC button could fail to turn on after failed NTP restored

• new: horizon coordinate grid on satellite pass map
• new: remote command set_display?on/off
• changed: remote set_touch command does not turn display on
• changed: blank out fb0 cursor after initial timeout period
• fixed: remote get_capture.bmp for largest size
• fixed: more efficient handling of failed remote command server

• fixed: allow escaping from DX Cluster pane if call not valid
• fixed: ignore taps between main seconds and UTC button
• changed: turn off UTC button if no NTP (in addition to large question mark)
• changed: remove trailing effect from RPi fb0 cursor over map

• new: show dx cluster port number
• new: 30 degree tick marks on satellite path horizon
• new: major work in preparation for gimbal and rotator support
• fixed: timezone values near Long Beach CA
• fixed: dx cluster report could overflow its pane boundary

• fixed: network issue when dx cluster and satellite both active
• fixed: incorrect spot callsign prefix

• fixed: compile bug on RPi

• fixed: several EEPROM settings were still getting lost. Hopefully this is the last EEPROM bug .. thanks for your patience.

• fixed: call sign was lost after Setup screen and some EEPROM values will need resetting

• fixed: DX Cluster could hang depending on connection state
• changed: leave DX Cluster host blank to disable entirely
• changed: allow call signs up to 11 characters long

• changed: DX Cluster now requires Setup server entry, there is no default
• fixed: improved plot data error messages

• new: tapping a DX Cluster spot will set it as new DX
• fixed: Wire.cpp compile error on some UNIX systems

• new: DX Spider spots are an option in the center plot pane
• changed: desktop no longer accepts host time, ? warning is displayed unless NTP network time is confirmed
• fixed: DX prefix tag could go off the map when very close to right edge of AZM projection
• fixed: possible missing WX error message
• fixed: change in V2.18 broke timezone offset near zone boundaries

• fixed: 24 hour clock-off bug
• fixed: added better desktop remote update error messages
• fixed: xray plot guards against bogus 0 values

• fixed: ESP sporatic rebooting

• change: ESP with photoresistor now also includes on/off timer control
• change: underline "DX:" to suggest it can be clicked for sat selection table
• fixed: tweaked several prefix locations

• new: show closest DX prefix when tap new location if one is near
• new: option to show DX prefix instead of sun rise/set times (tap to select)
• new: display on/off timer control if no photoresistor in ESP or RPi fb0
• change: sat selection shown only if requested (no longer shown on boot)
• change: significant core graphics redesign
• change: RPi FB0 cursor disappears after 2 seconds of no mouse motion
• fixed: turning on geoip in setup disables lat/long fields
• fixed: desktop network info now uses /sbin/ip if no /sbin/ifconfig
• fixed: add slash to desktop small font 0 to match ESP
• fixed: possible loss of desktop EEPROM emulation file

• new: show sat pass duration next to max elevation; remove zenith marker
• new: touching top and bottom edges of hours changes by 2, minutes by 10
• fixed: desktop map is brighter and has much simpler oceans
• fixed: NCXDF call sign could encroach on RSS area
• fixed: sat name over oceans better avoids DE and DX markers

• new: separate maps optimized for TFT and desktop displays
• new: third lat/long grid option showing tropics
• new: show NCDXF call sign beneath each station
• fixed: more natural character spacing in setup
• fixed: stop sun and moon from flashing when at right edge

• new: support for 2400x1440 and 3200x1920 desktop sizes; no feature changes.

• new: display serial number in network splash screen
• fix erasing ? when NTP resumes

• Argh, missed another spot for GFX library

• missed one spot for GFX library

• tighten up geometry for latest GFX library
• fix stopwatch rollover after 99 hours

• Change to accommodate Adafruit_RA8875.h version 1.3.3

• new: stopwatch
• new: tap Rise/Set to toggle between duration vs local time
• new: optional map lat/long grid

• added new server command to allow displaying any satellite:

     http://Your-HamClock-IP/set_sattle?name=abc&t1=line1&t2=line2 

  Like all the server commands, you can send this with most browsers or with curl or wget from the command line.
  Unfortunately, Chrome tries to be helpful so will not work unless you replace each blank with %20.

• coordination release, no functional changes

• new: VOACAP predictions may be made for short or long path
• new: tap sat name on map to get pass details (in addition to sat location)
• new: color key added to sat selection pane title
• new: better RPi X11 desktop drawing performance

• fixed: bearing and map used lat/long 0/0 after boot until set
• new: tapping bearing to toggle between short and long path changes distance to match

• fixed: preserve DE grid square
• fixed: DX grid square would show through if click there while sat pass is shown
• fixed: fill screen off by 1 pixel in X11 version

• new: tap bearing to toggle between long and short path
• new: tap sat name to see pass details (in addition to current sat location)
• fixed: disable tty1 getty on fb0 version

• fixed: do not start collecting sensor data until NTP time has succeeded
• fixed: say "No Set", not "No Rise", when geostationary satellite is visible from DE
• fixed: left-right cursor wrap in RPi fb0 version
• reduce flicker when sun is near moon
• Updated remote command set, send /help for list

• Change Band Conditions title to hopefully clarify the meaning of the table

• New option to set DE Lat/Long automatically using IP geolocation service
• 2x Mercator and 1.3x Azimuthal map drawing speed up
• Added some NOAA weather satellites to list

• Setting a new DX location shows VOACAP band predictions from DE

• fix bug in RPi version that interfered with WiFi configuration

• all new brightness controls

• only ask for WiFI credentials in Setup on ESP version, require user to setup their internet first on other versions

• fix bug where DE DST flag was not being restored from NVRAM
• fix bug causing moon to leave sparkles on edge of azimuthal map
• use manufacturing wifi credentials as initial default
• change brightness bulbs from yellow to white
• draw small symbol if photoresistor is detected
• draw satellite name grayed out in list if never rises at DE

• add light bulb icons as display brightness controls (ESP models only)
• fix rare issue when a satellite pass lasted less than 90 seconds

• do not draw DX marker if should be hidden by RSS
• allow lower case nsew in login screen
• remove blinking cursor in RPi fb0 version
• improve methods for discovering gateway and wlan0 ip in RPi version
• shorter network count-down
• add grid square touch to show possible alternate if not exactly at integral coordinates

• fix RPi fb0 cursor overflow along bottom edge
• don't redraw map if tap on UTC when already On
• don't briefly show DE info after refresh when analog clock is enabled
• fix down counter color in remote update pane

• Tweak analog clock hands
• fix bug if satellite pass curve is very short
• fill black border on RPi fb0 version to erase any system messages

• squeeze more Satellites in table

• fix character spacing issue in Setup screen
• fix issues building on Ubuntu-MATE

• only draw transmitting NCDXF beacons
• preselect No button to emphasize firmware update will not occur by default
• show satellite list name red if up now, green if up soon
• faster satellite list drawing

• Show time to next rise for each satellite in selection screen
• Start NTP rotation with time.google.com

• Swap colors for satellite track and footprint
• Label 0 (now) on plots with future predictions

• Increase tap hold time to 1 full second
• Draw satellite footprint in darker red to better distinguish from track
• Fix sometimes erasing screen lock padlock

• Add new analog DE clock option

• holding the screen lock padlock will restart
• use same stored colors in splash call sign

• fix sat pass graphic if maximum elevation less than 1 degree
• allow using keyboard in Setup pane if built for x11

• support for longer WiFi SSID and password

• add dew point sensor plot
• prompt Tap or Click

• Show Satellite name immediately when set a DX
• fix bug in desktop EEPROM emulation that eventually starved all io

• Satellite name cooperates with RSS

• label satellite name on map when not in DX region

• smoother sensor plot update after changing satellite
• report wifi RSSI on linux
• add hamclock-fb0-small Makefile target for RPi's with 7" screens
• more reliable reporting of MAC address

• don't ask rotation on desktops

• restore uptime after changing satellite

• higher resolution moon symbol on big desktop versions
• better looking J on big desktop versions
• fix occasional missing or partially drawn lines in desktop versions

• big desktop versions display commensurately higher resolution SDO images

• support self updating in desktop versions too
• tap Version to check whether an update is available (all versions)

• allow resizing desktop versions
• allow listing more satellites

• better moon rendering

• fix stray satellite path pixels at edge of Azimuthal view

• add support for linux, RPi and macOS desktop

• fix problem where a new sat selection was not always used

• add satellite and settime RESTful commands
• improve checking whether TLE is suitable epoch
• improve Bosch BME280 temperature and humidity accuracy

• label satellite path zenith and maximum elevation
• add memory and reboot RESTful commands

• remove grayline option, replace GRA button with AZM
• improve memory management for long paths
• add count down to firmware update screen
• fix sat tracks leaving pixels on map edge

• better twilight for RPi version too

• much better grayline twilight graphics
• erase dx marker and path when changing to Satellite info mode

• better screen management going into and back from sat selection page
• refresh sat info if user changes time a lot
• increase current satellite location tap area
• fix tapping area for dx lat/long

• add display of Earth satellites

• linux version now just uses existing network
• progress dots replaced with count down
• improved environment sensor initialization and expand plot to 25 hours
• better http handling
• reduce linux map raster jaggies

• fix xray level designation below A and above X

• display xray level designation
• accommodate more RPi screen resolutions
• fix rainbow on RPi

• new Earth map
• add support in RPi version for Bosch BME280 environment sensor

• first release supporting Raspberry Pi
• refresh RSS immediately when toggle map projection
• display complete IP address
• fix box around wx report that did not quite match the alternate plot

• show device MAC address before connecting

• RSS now occupies 2 rows

• all new RSS system that retrieves from my server
  • displays round robin from ARRL, Southgate, eHam and DXNews
• label weather units

• remove eHam RSS because they now redirect to https and there is no room in Huzzah to support https.

• add Setup option to enter initial DE lat and long
• center date better under wider call sign area
• timezone table now uses 1 degree resolution
• add photocell wiring to README

• add Setup option to rotate screen
• squeeze out a little more room for wider call signs
• offer a little more time to choose Recalibrate and Setup screens

• remove option to downgrade
• fix plot bug if sensor drops out for extended period then recovers

• More automated remote update knows when a new version is available
• Touch now supports auto-repeat in most fields
• Add degree symbol to weather temperature value
• Add more specific weather error messages

• Show weather data for 30 seconds after changing DE or DX

• a little more map detail
• more robust RSS parser
• faster WiFi retries when signal is lost
• fix RSS flashing when no WiFi signal
• increase clock from 80 to 160 MHz

• eliminate need for Shift key in setup keyboard -- show both cases at once
• Raise upper case J in smaller font

• add remote WiFi firmware updating
• smoother brightness control
• fix speckles across the bottom of RSS banner
• allow 0-length setup fields
• more efficient Grayline toggle
• new RESTful commands:
  • http://<HamClock_ip>/newdegrid?AB12
  • http://<HamClock_ip>/newdxgrid?AB12

• better J in regular font
• softer border lines
• use separate colors for short and long path
• add more instructions for touch screen calibration
• more grid square mods

• add Azimuthal projection option
• add WiFi connection progress dots
• add degree symbol after bearing angle

• accommodate changes in ESP library version 2.4.0 and still maintain compatibility with older versions

• allow Huzzah to reuse stored SSID for faster booting and faster recovery if WiFi comes back
• fix for rare compile problem related to Time.h by changing to TimeLib.h
• split right plot touch so top half cycles SDO images and bottom half cycles sensor plots (if installed)
• tweak xray download code

• further improve rendering call signs containing descending characters
• improve WiFi state reporting and resilience to NTP errors
• plot both long and short XRay wavelengths

• add padlock icon that locks screen
• tweak time zone for Bouvet Island

• alternate WiFi dBm with IP

• redirect all web accesses to CSI server
• increase wifi login timeout

• Tweak RESTful commands
  • http://<HamClock_ip>/touch?x=X&y=Y
  • http://<HamClock_ip>/capture.bmp
  • http://<HamClock_ip>/help

• 25 hour XRay plot
• More RESTful commands, returns new values in JSON format if applicable
  • http://<HamClock_ip>/capture
  • http://<HamClock_ip>/sensors
  • http://<HamClock_ip>/grayline?on/off
  • http://<HamClock_ip>/newde?lat=X&lng=Y
  • http://<HamClock_ip>/newdx?lat=X&lng=Y

• avoid pressure values overflowing plot size in metric mode

• reduce clock flicker -- contributed by W2ROW

• add Metric/Imperial setup option to choose sensor plot units

• make GRA button more consistent with RSS
• fix rounding error in maidenhead grid square calc
• reset sensor queue if fails to restart

• add grayline on/off button

• add grayline down to 12° twilight

• better setup keyboard

• improve rendering of call signs with descending characters J and Q

• fix SDO web site name

• fix display bug if solar flux prediction download fails

• improve drawing lunar phases
• reset the Bosch sensor if any value seems bogus

• posted to QST in-depth

All contributed scripts referred to below are available in this zip file

        ./hceeprom.pl NV_CALLSIGN s
        NV_CALLSIGN = WB0OEW
        

        ./hceeprom.pl NV_CALLSIGN s AB1XYZ
        NV_CALLSIGN = AB1XYZ
        

        ./hceeprom.pl NV_DX_LAT f -23.4 
        NV_DX_LAT = -23.4
        

        perl -i -p -e "/#will be incremented$/ and s/p1=\d+/p1=$p1_next/" ${0}
        

HamClock was originally developed for the ESP8266 such as the Adafruit Huzzah. But after I created a porting layer, it may now also be built for Raspberry Pi, macOS, Ubuntu, FreeBSD, Windows WSL or most any other UNIX-like system supporting the X11 Windows system.

Instructions are below, but first a few preliminaries:

• HamClock may be built in the following sizes. It can either be in its own window of this size or it can run in "full screen mode" in which it centers itself in a black background the full size of the display.
  • 800 x 480
  • 1600 x 960
  • 2400 x 1440
  • 3200 x 1920
• All UNIX versions of HamClock emulate the ESP non-volatile EEPROM by storing values in the file ~/.hamclock/eeprom. Removing this file and restarting HamClock will reset it back to all default values.
• For those who may be aware, there is also a non-X11 version of HamClock for RPi that uses direct frame buffer access. This version is referred to as the "fb0" configuration. If you have not heard of fb0, just skip this section and go directly to installation, below. Although still supported for automatic updates, fb0 is no longer recommended for new installs. Prior to version 2.58 fb0 was the only way to get HamClock to use the full screen, but full screen is now available in the GUI version so fb0 is no longer required. If you have fb0 already installed, please remove it before performing the installation steps below. This requires the following steps:
  1. log into your RPi with ssh
  2. stop automatically starting hamclock, for example if you used crontab, type crontab -e and remove the line that runs hamclock
  3. Make sure the GL driver is enabled by running sudo raspi-config and doing

     Advanced Options ⇒ GL driver ⇒ OpenGL with fake KMS ⇒ Ok
     don't reboot yet

  4. While still in sudo raspi-config restore using the GUI by doing

     System Options ⇒ Boot ⇒ Desktop Autologin ⇒ Ok ⇒ Finish ⇒ Reboot? Yes

  5. if not already rebooted from the previous step, reboot now by typing sudo reboot

To install HamClock follow these steps:

1. Open a terminal directly on the target system GUI desktop to get a command line prompt.
   Do not use ssh unless you know what ssh -X means.
2. Run these commands (use copy/paste to avoid typos):

   cd ~
   rm -fr ESPHamClock
   curl -O https://www.clearskyinstitute.com/ham/HamClock/ESPHamClock.zip
   unzip ESPHamClock.zip
   cd ESPHamClock
   make -j 4 hamclock-800x480
   sudo make install
   

3. Now run HamClock by typing:

   hamclock &
   

4. Be sure to read the User Guide to get the most from HamClock!
5. To exit hamclock, click and hold the padlock icon for three seconds, then choose Exit.
6. If you get build errors during make:
   • on RPi try loading more packages such as

     sudo apt-get -y install make g++ libx11-dev xserver-xorg raspberrypi-ui-mods lightdm lxsession
     

     If still trouble, note I only test on the latest desktop release of Raspberry Pi OS so if you are running something older it might help to upgrade.
   • on Ubuntu try loading more packages such as

     sudo apt install curl make g++ xorg-dev
     

   • on macOS try installing XQuartz and Xcode. Then run

   xcode-select --install
   

   • on FreeBSD try loading more packages such as

     sudo pkg install gcc libX11 gmake curl
     

     then use gmake instead of make
7. The example make command above will build HamClock with 800x480 pixels. You can also make these sizes:
   • hamclock-1600x960
   • hamclock-2400xx1440
   • hamclock-3200x1920
   If you do, redo both make commands again, for example:

   cd ~/ESPHamClock
   make -j 4 hamclock-1600x960
   sudo make install
   

8. If you would like HamClock to fill the screen, set that option on Page 4 of Setup. With this option HamClock will still be the same screen size you built, but it will fill any surrounding gap with black so there is nothing else showing. If you really want HamClock to use all available screen space, see the FAQ about making different sizes.

   Note that if never run previously, HamClock will automatically set the full screen option if the display size is the same as the size specified in the make command.

9. If you would like a Desktop icon with which to start HamClock on RPi, try these commands:

   cd ~/ESPHamClock
   mkdir -p ~/.hamclock
   cp hamclock.png ~/.hamclock
   cp hamclock.desktop ~/Desktop
   

10. If you would like HamClock to start automatically when you boot your RPi, try these commands:

    cd ~/ESPHamClock
    mkdir -p ~/.config/autostart
    cp hamclock.desktop ~/.config/autostart
    

11. On macOS, you can turn the bare executable into a clickable App on your Desktop as follows:

    cd ~/ESPHamClock
    HCDIR=~/Desktop/HamClock.app
    mkdir -p $HCDIR
    echo '#!/bin/bash' > $HCDIR/HamClock
    echo '/usr/local/bin/hamclock &' >> $HCDIR/HamClock
    chmod u+x $HCDIR/HamClock
        

    To give it a proper icon:

    1. open hamclock.png with Preview
    2. click on the image
    3. type ⌘-A to select the image
    4. type ⌘-C to copy the image to the clipboard
    5. right-click the new HamClock.app Desktop item and select Get Info
    6. click the existing default icon in the upper left corner
    7. type ⌘-V to paste a new icon
    8. close Get Info
    9. close Preview

    To put it in the Dock:

    1. edit the script and temporarily remove the trailing & (dock icons bounce until the parent process exits)
    2. double-click to launch HamClock.app
    3. while it's bouncing in the dock, right-click and select Options → Keep in Dock
    4. exit HamClock
    5. remember to put back the &

    For a little more decorum, create a bona fide app using Platypus. I tried it briefly on Big Sur and found it easy to use and worked well. Use the same 2-line script as above but without the & so Platypus can properly inform the OS when you exit HamClock.