README

A simple Local (24-hour) and UTC datetime clock, because I can never tell what UTC time means when I'm reading logs.

Runs on a Raspberry Pi with a Waveshare e-ink screen.

Vertical layout for three clock view.

Picking out your screen

I recommend getting a Waveshare e-paper HAT that screws right into your Pi, otherwise you'll have to use the guide for your screen to plug individual connectors into GPIO pins.

I got the 2.7inch e-Paper HAT, some tweaking might be needed for other boards.

Installation

Hardware

Connect the screen to your raspberry pi as instructed.

Raspberry Pi OS

1. Download and install the raspberry pi imager.
2. Install the appropriate 32/64-bit OS on your microSD card.
   1. Lite versions are ok to use
   2. I don't know why, but the Raspberry OS Imager Wi-Fi credentials never set properly for me, so I ended up doing it manually, step is below. All other Imager configs worked as expected.
3. Mount your SD card again. In config.txt uncomment dtparam=spi=on
4. Fill out conf/wpa_supplicant.conf with your Wi-Fi credentials
5. Copy the files in ./conf/ onto your SD card in its root
6. Insert your SD card into your pi and start it up (it might take a couple of minutes before your Pi connects to Wi-Fi)
7. scp the setup.sh file to your Pi, and run it. If you want to set the local timezone or a third alternate timezone, use the following flags (both optional):
   1. ./setup.sh --local US/Eastern --alt US/Pacific # Both flags optional
   2. setup.sh installs all dependencies and sets up the clock as a service via systemctl (utc-clock.service).