DragonFly On-Line Manual Pages

Search: Section:  


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.1-DEVELOPMENT September 4, 2020 DragonFly 6.1-DEVELOPMENT

Search: Section: