TDC(1)

💖 TDC(1) — User Commands 💖

okay so bestie, welcome to the tdc page 💅 this is the manual for Tiny Dockable Clock, section 1 of the manual, and honestly? it's giving tiny but mighty.

---

✨ NAME ✨

tdc — a stand-alone clock that's designed to run as a dock application but is literally not required to 🕐

---

🦋 SYNOPSIS 🦋

tdc [options]

---

🌸 DESCRIPTION 🌸

Tiny Dockable Clock (tdc) is, no cap, a simple and tiny dockable clock. that's the whole vibe. 💖

TDC is a stand-alone clock for the X Window System / X11 (like XOrg or XFree86, iykyk). it has minimal build and run-time dependencies — like, barely any. and TDC works with virtually any EWMH-compliant window manager. every single one. iconic behavior fr fr. 👑

the behavior AND the look of TDC can be configured either via command line options or via a configuration file. and as usual: command-line options have precedence over the options you put in the configuration file. so if you're confused why your config file isn't winning, that's why bestie 😭

---

✨ OPTIONS ✨

this program follows the usual command line syntax, with long options starting with two dashes (-). a summary of the options is included below 🎀

• -t, --font — the font face to use. default is Mono.
• -b, --bold — use a bold font. bold of you to assume, but okay, slay 💅
• -s, --fontsize — the font size to use. default is 12.0.
• -c, --color — the font color to use. default is white.
• -w, --width — the width of the dockapp window. default is 64.
• -f, --format — the time format to use. default is %T. you can get format codes from the man page for strftime.
• --enable-cal — enable the calendar feature, which gets opened by clicking the clock 🗓️✨
• --calfont — the font that will be used in the calendar. default is Mono.
• --calfontsize — the font size used in the calendar. default is 14.0.
• --hlcolor — the highlight color to use in the calendar. default is grey30.
• -h, --help — show help information and exit.
• -v, --version — show version information and exit.

---

🌈 XDEFAULTS 🌈

the following options can be set in $HOME/.Xdefaults:

tdc*font
tdc*bold
tdc*fontsize
tdc*enable-cal
tdc*calfont
tdc*calfontsize
tdc*color
tdc*hlcolor
tdc*width
tdc*format

---

💜 EXAMPLES 💜

these are some samples you may be interested in 👀

tdc --width 110 --format "%x %H:%M"
tdc --width 130 --format "%x %H:%M:%S"
tdc --width 230 --format "%a, %d %b %Y %T %z"
tdc -w 110 -f "%x %H:%M" --enable-cal --hlcolor=grey40

---

🎀 FILES 🎀

• $HOME/.Xdefaults — specify defaults for tdc to refer to. this is discussed above ⬆️

---

💀 BUGS 💀

if you experience bugs, the best way to report them is to the upstream bug tracker. this can be found at https://github.com/MTecknology/tdc/issues. pls report them, don't just suffer in silence bestie 🙈

this manual page was written by Michael Lustfield <michael@lustfield.net> 🫶

---

and that's the whole page!! 🍓 this was tdc version 2.0, dated 12/10/2023, and it ate, no crumbs left. go run your little dockable clock bestie, it's literally main character energy ⭐🧚💖