Using the Clock and Prefs

Documentation / Cyclock Desk Clock

• Overview of Cyclock
  • What It Does
  • What It Is Not
• Using the Clock and Prefs
  • The Face Window
  • Preferences Tabs
  • Live Apply
• Keys and Command Line
  • Face Keys
  • Command Line
  • Configuration File
• Copyright

Using the Clock and Prefs

Cyclock is the face window. cyclock-prefs is the settings panel. Both share ~/.cyanotype/cyclock.conf. Help on the prefs panel opens this book (class CyclockPrefs).

The Face Window

The face fills the window. Right-click opens a popup menu with a Faces cascade, Borderless, Preferences, About CyClock (formative notes for each face), and Quit. Borderless faces are shaped so the wallpaper shows beside the dial; left-mouse drag moves a borderless window.

Number keys and brackets change faces without opening prefs. Space starts or stops the chronograph on faces that have one. p opens preferences; q or Esc quits.

Preferences Tabs

cyclock-prefs tabs (as shipped):

• General -- timezone, window, second-hand tip, fonts, sound.
• Face -- face selector plus options that belong only to the selected face (for example abyss glow, LCD knobs, ship_weather complications).
• Weather -- station, units, and poll interval for faces that show weather (global; drives ship complications).
• Alarms -- scrollable list with Add / Edit / Delete.

A Timer tab appears when countdown expire prefs are in play for the timer face.

Live Apply

There is no Apply button. Every control writes conf and signals a running cyclock (SIGHUP / --notify) as soon as you change it. Close leaves the last written values. Help opens this book.