DragonFly On-Line Manual Pages

DFLYCLOCK(1)           DragonFly General Commands Manual          DFLYCLOCK(1)

NAME
     dflyclock - The best X11-based clock

SYNOPSIS
     dflyclock [-rsmvh] [-12/24] [-geometry x11geom] [-dom] [-nodom]
               [-strftime format] [-strftime2 format] [-font name]
               [-font2 name] [-S scale] [-shape] [-noshape] [-subsecond]
               [-t shape_type] [-b borderpix] [-fg ffffff] [-bg 000000]
               [-t2 e0e000]

DESCRIPTION
     The dflyclock implements an analog or analog+digital clock on an X11
     desktop.  Written from scratch, it fixes the innumerable annoyances with
     most other X11 based clocks such as flicker, missing important date
     information such as the day of week, and so forth.  TrueType fonts are
     also supported.

     The application runs in the foreground.  If you wish to run it in the
     background, use notty(1).

     Features include:

     *  Resizable, and the selected fonts will auto-scale.

     *  Double-buffered for flicker-free updates (except seconds hand).

     *  An XOR'd seconds hand to reduce cpu and graphics overhead to almost
        zero.

     *  Ability to use TrueType fonts.

     *  Automatic centering of font (no need to use a monospaced font).

     *  Two completely programmable text fields (strftime style).

     *  Shaped window support.

OPTIONS
     dflyclock has fairly nice defaults and implements a large number of
     options for customization.

     -12/24  Set 12-hour mode (default) or 24-hour mode.  In 12-hour mode an
             'a' or 'p' is tacked onto the default time format.

     -geometry x11geom
             Specify an X11 geometry.  For example '100x100-1-1'

     -dom    Include short text on main face (default).  This typically uses a
             large font.

     -nodom  Remove any text on the main face.

     -strftime format
             Specify the bottom text using strftime formatting.

     -strftime2 format
             Specify the face text using strftime formatting.

     -font name
             Specify the bottom font.  The string may also include a single
             optional %f for point size, allowing dflyclock to dynamically
             size the font.

     -font2 name
             Specify the face font.  The string may also include a single
             optional %f for point size, allowing dflyclock to dynamically
             size the font.  dflyclock

     -S scale
             Scale the point size.  This helps the user optimize any displayed
             text for the window.  The default is 0.5.

     -shape  Use a shaped circular/oval window (default).

     -noshape
             Use a normal square window.

     -subsecond
             Waste some CPU (though not much since the seconds hand is
             implemented via XOR instead of double-buffering).

     -r      Reverse fg/bg colors.

     -s      Include a second's hand (default).

     -m      Do not include a second's hand.

     -v      Print version an exit.

     -h      Print help.

     -t shape_type
             Specify the shape type.  Currently only type '1' is supported.

     -b borderpix
             Specify the border size in pixels.

     -fg ffffff
             Specify forground color, 6 hex digits rrggbb.

     -bg 000000
             Specify background color, 6 hex digits rrggbb.

     -t2 e0e000
             Specify bottom time bar color, 6 hex digits rrggbb.

INSTALLATION
     Generally speaking you should install the 'xorg' pkg from dports and then
     start this application up from your .xinitrc file.  This application runs
     under X11.  For example:

     /bin/notty /usr/local/bin/dflyclock -geometry 270x280-15+0

SEE ALSO
     notty(1), pkg(8)

HISTORY
     The dflyclock command was written by Matthew Dillon and first appeared in
     DragonFly 5.9 as an add-on project after the author became frustrated
     with all the other badly written X11 clock apps.

DragonFly 6.5-DEVELOPMENT      September 4, 2020     DragonFly 6.5-DEVELOPMENT