yclock

A simple analog clock application for macOS, inspired by xclock from X11 that you're used to on Linux and the BSDs.

• Analog and digital clock modes (toggle with ⌘D)
• Optional seconds display (toggle with ⌘S)
• Real-time updates every second
• Clean, minimal interface with no window chrome
• Draggable anywhere on the clock face
• Translucent window
• Themeable via configuration file
• Command line options for startup mode

yclock [OPTIONS]

Options:
  --digital         Start in digital mode
  --analog          Start in analog mode (default)
  --analogue        Same as --analog
  --seconds         Show seconds hand/display
  --show-in-dock    Show app in Dock and Cmd+Tab switcher
  --font-name NAME  Specify font name for digital clock
  --help            Show this help message

Examples:
  yclock --digital --seconds
  yclock --analog
  yclock --digital --font-name Menlo
  yclock --font-name "Courier New" --seconds
  yclock --show-in-dock

yclock can be themed by creating a configuration file. The app looks for config files in the following order:

1. ~/.yclock.conf
2. ~/.config/yclock/yclock.conf
3. $XDG_CONFIG_HOME/yclock/yclock.conf

See conf/yclock.conf for the format. The default theme is Catppuccin Macchiato.

Example configuration:

# Colors in RGB hex format
background = #24273a
foreground = #cad3f5
second_hand = #ed8796

# Clock mode (analog or digital)
mode = analog

# Window dimensions
width = 164
height = 164

# Font name for digital clock (optional)
# Examples: Menlo, Monaco, Courier, Helvetica, Arial
font = Menlo

# Show app in Dock and Cmd+Tab switcher (default: false)
# When false, app runs as an accessory and doesn't appear in Dock or Cmd+Tab
# show_in_dock = false

• macOS 11.0 or later
• Xcode Command Line Tools (for swiftc compiler)

$ make clean && make build

$ make run

$ make test

Install the application and man page to /Applications:

$ make install

This will install both the application bundle and the man page. After installation, you can view the manual with:

$ man yclock

and start the application with:

$ yclock

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.