# PupClockset 2.3.1

## Recommended OS

Puppy Linux with gtkdialog4 (0.7.21 or greater)

## Supported Window Manager and Panels

FBPanel, Fluxbox, IceWM, JWM, LXDE, LXPanel, Tint2, Xfce4
(and Openbox WM, when linked to a supported panel)

## Purpose and Base Features

The digital-tray clock, which is a common feature of many window managers and panels, can display time and date in multiple formats based on strftime specifications. PupClockset automatically detects the active window manager or panel, and provides an intuitive interface for changing the clock format and font attributes. Program access is by Puppy Menu->Desktop->(Desktop Settings)->PupClockset, or by a single mouse-click of the tray clock in FBPanel, IceWM, JWM, LXDE, LXPanel and Tint2. Quick links are provided to the Osmo personal organizer, Puppy set-time tool, and Psync.

## PupClockset strftime specifiers

Set 1 - %l:%M %p
Set 2 - %l:%M:%S %p (or %r)
Set 3 - %a %l:%M %p
Set 4 - %a %d %b %l:%M %p
Set 5 - %H:%M (or %R)
Set 6 - %H:%M:%S (or %T)
Set 7 - %a %H:%M
Set 8 - %a %d %b %H:%M

%a Abbr. weekday name
%b Abbr. month name
%d Two-digit day of month
%H Hour of the day, 24-hr
%I Hour of the day, 12-hr
%M Minute of the hour
%p Meridian indicator, AM/PM
%S Second of the minute

## Caveats

1. PupClockset supports standard configuration files of the IceWM, JWM and Fluxbox window managers, and the default panel profiles of FBPanel, LXPanel/LXDE and Tint2, but does not support the variance of modified or non-default panel profiles.
2. Many panels support strftime specifiers for the multi-format display of time and date, but may not uniformly support the Pango Markup Language for the enhancement of font attributes.
3. The Openbox window manager has no built-in panel or clock, but is frequently enhanced by FBPanel, LXPanel, Tint2, or secondary dock plug-ins.
4. The Fluxbox window manager typically works well with PupClockset, but at times Fluxbox can be a little temperamental when responding to the restart command if multiple additional applications are active on screen. Consequently, you may want to limit the number of background applications when changing the clock.
5. By default, a mouse-click of the tray clock will open PupClockset, or you can set this option to open a small pop-up calendar if minixcal is installed.
6. PupClockset does not support the clocks of the Cinnamon, Enlightenment, KDE or Mate desktop environments.

## Availability

The current version of PupClockset is available here.

## License

GNU GPLv3, Copyright 2010-2015, Roger D. Grider