summaryrefslogtreecommitdiff
path: root/word-clock-widget/README.md
blob: 9bf1032b921565fe90e30e5aeabfcc6bfdee9f0f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
# word 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 |

## Installation

Clone repo, include widget and use it in **rc.lua**:

```lua
local word_clock = require("awesome-wm-widgets.word-clock-widget.word-clock")
...
s.mytasklist, -- Middle widget
	{ -- Right widgets
    	layout = wibox.layout.fixed.horizontal,
		...
		word_clock(),		
	...
```

# Screenshots

```lua
 word_clock{
    font = 'Carter One 12',
    accent_color = '#ff79c6',
    main_color = '#8be9fd',
    is_human_readable = true,
}
```
![](./screenshots/halfpastthree_color.png)


```lua
word_clock{
    font = 'Carter One 12',
    is_human_readable = true,
}
```
![](./screenshots/twentythreepastnine.png)


```lua
word_clock{
    font = 'Carter One 12',
    is_human_readable = true,
    military_time = true
}
```
![](./screenshots/twentythreepasttwentyone.png)


```lua
word_clock{
    font = 'Carter One 12',
    accent_color = '#f00',
    main_color = '#0f0',
}
```
![](./screenshots/onetwentyseven.png)