From 5e0030094446cd064fd2ca79dc69e9a6efab4712 Mon Sep 17 00:00:00 2001 From: streetturtle Date: Wed, 25 Nov 2020 09:33:35 -0500 Subject: [text-clock] update readme --- text-clock-widget/README.md | 51 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 text-clock-widget/README.md (limited to 'text-clock-widget/README.md') diff --git a/text-clock-widget/README.md b/text-clock-widget/README.md new file mode 100644 index 0000000..0c07507 --- /dev/null +++ b/text-clock-widget/README.md @@ -0,0 +1,51 @@ +# Text clock widget + +Widget displaying current time using words: + +![screenshot](./screenshots/halfpastthree.png) + +## Customization + +It is possible to customize widget by providing a table with all or some of the following config parameters: + +| Name | Default | Description | +|---|---|---| +| main_color | `beautiful.fg_normal` | Color of the word on odd position | +| accent_color | `beautiful.fg_urgent` | Color of the word on even position | +| font | `beautiful.font` | Font (`Play 20`) | +| is_human_readable | `false` | _nine fifteen_ or _fifteen past nine_ | +| military_time | `false` | 12 or 24 time format | +| with_spaces | `false` | Separate words with spaces | + +# Screenshots + +```lua + text_clock{ + font = 'Carter One 12', + accent_color = '#ff79c6', + main_color = '#8be9fd', + is_human_readable = true, +} +``` +![](./screenshots/halfpastthree_color.png) + + +```lua +text_clock{ + font = 'Carter One 12', + is_human_readable = true, +} +``` +![](./screenshots/twentythreepastnine.png) + + +```lua +text_clock{ + font = 'Carter One 12', + is_human_readable = true, + military_time = true +} +``` +![](./screenshots/twentythreepasttwentyone.png) + + -- cgit v1.2.3