peaclock

A responsive and customizable clock, timer, and stopwatch for the terminal.


peaclock

/

config

/

default

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 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180
# peaclock
# default config
#
# The config file in the config directory must be named 'config'.
# It is a plain text file that can contain any of the commands listed
# in the 'Commands' section of the '--help' output.
# Each command must be on its own line.
# Lines that begin with the '#' character are treated as comments.
#
# For more information, refer to the 'Configuration' and 'Commands'
# sections of the programs help output with '--help' or '-h'.

# -----------------------------------------------------------------------------
# general
# -----------------------------------------------------------------------------

# set the x y block size, the width and height of an individual block composing
# the clock
block 2 1
# block-x 2
# block-y 1

# set the x y padding size, the width and height of the space between each
# individual block composing the clock
padding 0 0
# padding-x 2
# padding-y 1

# set the x y margin size, the space around the outside of the clock from the
# edge of the terminal
margin 0 0
# margin-x 0
# margin-y 0

# set the x y ratio size, auto adjust the clock to conform to a specific
# aspect ratio, keep in mind that a square ratio would be '2 1' due to a
# terminal character cell having a height around twice the size of its width
ratio 2 1
# ratio-x 2
# ratio-y 1

# set the padding size between the date and the clock
date-padding 1

# set the string value used to fill the active, inactive, and colon blocks of
# the clock, an empty string clears the value
fill ''
# fill-active ''
# fill-inactive ''
# fill-colon ''

# set the locale, for example 'en_CA.utf8', an empty string clears the value
locale ''

# set the timezone, for example 'America/Vancouver', an empty string clears the
# value
timezone ''

# set the date format string, an empty string clears the value
date '%a %b %d'

# set the mode type
# select one of:
# clock, timer, or stopwatch
mode clock

# set the view type
# select one of:
# date, ascii, digital, binary, or icon
view digital

# set the value to adjust with the hjkl;' keys
# select one of:
# block, padding, margin, ratio, active-fg, inactive-fg, colon-fg,
# active-bg, inactive-bg, colon-bg, background, or date
toggle active-bg

# set the stopwatch to start
# clear, stop, start, 00h:00m:00s
stopwatch start

# set the timers initial value
# clear, stop, start, 00h:00m:00s
timer 10m:0s

# set the string value to be executed by a shell upon timer completion,
# an empty string clears the value
timer-exec 'notify-send -a peaclock "timer complete"'

# set the duration in milliseconds between reading user input
rate-input 50

# set the duration in milliseconds between redrawing the output
rate-refresh 1000

# set the duration in milliseconds to display status messages
rate-status 5000

# -----------------------------------------------------------------------------
# toggles
#
# set <value> <on|off>
# -----------------------------------------------------------------------------

# use 24 hour time
set hour-24 on

# display seconds
set seconds off

# display the date
set date on

# auto size the clock to fill the screen, overrides the current x y block size
set auto-size on

# auto size the clock to use the aspect ratio set by the command 'ratio',
# overrides the current x y block size and auto-size
set auto-ratio on

# -----------------------------------------------------------------------------
# styles
#
# style <value> <#000-#fff|#000000-#ffffff|0-255|Colour|reverse|clear>
#
# 24-bit colour
# #000000-#ffffff
#
# 8-bit colour:
# 0-255
#
# 4-bit colour:
# black [bright]
# red [bright]
# green [bright]
# yellow [bright]
# blue [bright]
# magenta [bright]
# cyan [bright]
# white [bright]
# -----------------------------------------------------------------------------

# set the style of the text set by the command 'fill' used to draw active
# blocks in the clock
style active-fg clear

# set the style of the text set by the command 'fill' used to draw inactive
# blocks in the clock
style inactive-fg clear

# set the style of the text set by the command 'fill-colon' used to draw colon
# blocks in the clock
style colon-fg clear

# set the style of the background used to draw active blocks in the clock
style active-bg reverse

# set the style of the background used to draw inactive blocks in the clock
style inactive-bg clear

# set the style of the background used to draw colon blocks in the clock
style colon-bg clear

# set the style of the background used to draw colon blocks in the clock
style date clear

# set the style of the background
style background clear

# set the style of the date
style text clear

# set the style of the command prompt symbol shown at the start of the line
style prompt clear

# set the style of the prompt status on success
style success green

# set the style of the prompt status on error
style error red
Back to Top