2 .\" Copyright (c) 2019-2020 The DragonFly Project. All rights reserved.
4 .\" This code is derived from software contributed to The DragonFly Project
5 .\" by Matthew Dillon <dillon@backplane.com>
7 .\" Redistribution and use in source and binary forms, with or without
8 .\" modification, are permitted provided that the following conditions
11 .\" 1. Redistributions of source code must retain the above copyright
12 .\" notice, this list of conditions and the following disclaimer.
13 .\" 2. Redistributions in binary form must reproduce the above copyright
14 .\" notice, this list of conditions and the following disclaimer in
15 .\" the documentation and/or other materials provided with the
18 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20 .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
21 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
22 .\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
23 .\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
24 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
26 .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
27 .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
28 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36 .Nd The best X11-based clock
41 .Op Fl geometry Ar x11geom
44 .Op Fl strftime Ar format
45 .Op Fl strftime2 Ar format
52 .Op Fl t Ar shape_type
60 implements an analog or analog+digital clock on an X11 desktop.
61 Written from scratch, it fixes the innumerable annoyances with most
62 other X11 based clocks such as flicker, missing important date information
63 such as the day of week, and so forth. TrueType fonts are also supported.
65 The application runs in the foreground. If you wish to run it in the
72 Resizable, and the selected fonts will auto-scale.
74 Double-buffered for flicker-free updates (except seconds hand).
76 An XOR'd seconds hand to reduce cpu and graphics overhead to almost zero.
78 Ability to use TrueType fonts.
80 Automatic centering of font (no need to use a monospaced font).
82 Two completely programmable text fields (strftime style).
84 Shaped window support.
88 has fairly nice defaults and implements a large number of options for
92 Set 12-hour mode (default) or 24-hour mode.
93 In 12-hour mode an 'a' or 'p' is tacked onto the default time format.
94 .It Fl geometry Ar x11geom
95 Specify an X11 geometry. For example '100x100-1-1'
97 Include short text on main face (default).
98 This typically uses a large font.
100 Remove any text on the main face.
101 .It Fl strftime Ar format
102 Specify the bottom text using strftime formatting.
103 .It Fl strftime2 Ar format
104 Specify the face text using strftime formatting.
106 Specify the bottom font. The string may also include a single
107 optional %f for point size, allowing
109 to dynamically size the font.
111 Specify the face font. The string may also include a single
112 optional %f for point size, allowing
114 to dynamically size the font.
117 Scale the point size.
118 This helps the user optimize any displayed text for the window.
121 Use a shaped circular/oval window (default).
123 Use a normal square window.
125 Waste some CPU (though not much since the seconds hand is implemented
126 via XOR instead of double-buffering).
128 Reverse fg/bg colors.
130 Include a second's hand (default).
132 Do not include a second's hand.
134 Print version an exit.
137 .It Fl t Ar shape_type
138 Specify the shape type.
139 Currently only type '1' is supported.
140 .It Fl b Ar borderpix
141 Specify the border size in pixels.
143 Specify forground color, 6 hex digits rrggbb.
145 Specify background color, 6 hex digits rrggbb.
147 Specify bottom time bar color, 6 hex digits rrggbb.
150 Generally speaking you should install the 'xorg' pkg from dports and
151 then start this application up from your .xinitrc file.
152 This application runs under X11. For example:
154 .Li /bin/notty /usr/local/bin/dflyclock -geometry 270x280-15+0
161 command was written by Matthew Dillon and first appeared in
163 as an add-on project after the author became frustrated with all the
164 other badly written X11 clock apps.