yorukot/tmlshock

A terminal ttl clock and stopwatch build by golang

About tmlshock

Terminal ttl clock, including customizable clock timer and stopwatch

Contents

• Install
• Usage
  • Clock
  • Stopwatch
  • Timer
• Setting
  • Color
    • Colon color
  • Disable second
  • Enable date
  • Date formate
  • Disable hour
  • 12 hours format

Install

see release

download tmlshock file and move it to /usr/local/bin

sudo mv ./tmlshock /usr/local/bin

Usage

COMMANDS:
   stopwatch, s  Start a stopwatch
   timer, t      Start a timer
   clock, c      Start a clock
   help, h       Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --color value, -c value  Set the string color see full color in
   --help, -h               show help
   --version, -v            print the version

Clock

NAME:
   tmlshock clock - Start a clock

USAGE:
   tmlshock clock [command options] [arguments...]

OPTIONS:
   --color value, -c value                Set the string color
   --second value, -s value, --sec value  Set the clock with second(true or false) (default: "true")
   --date value, -d value                 Set the clock with date(true or false) (default: "false")
   --dateformate value, --df value        Set the clock date formate (default: "2006/02/01")
   --colon-color value, --cc value        Set the colon color 
   --hour-format value, --hf value        Set the clock 24 hr or 12hr (type 24 or 12)
   --help, -h                             show help

Stopwatch

USAGE:
   tmlshock stopwatch [command options] [arguments...]

OPTIONS:
   --color value, -c value           Set the string color 
   --disable-hour value, --dh value  Disable hour(true or false)
   --colon-color value, --cc value   Set the colon color 
   --help, -h                        show help

Timer

USAGE:
   tmlshock timer [command options] [arguments...]

OPTIONS:
   --color value, -c value                Set the string color 
   --hour value, --hr value               Enter how many hours you want to count down
   --minute value, -m value, --min value  Enter how many minunts you want to count down
   --second value, -s value, --sec value  Enter how many seconds you want to count down
   --time value, -t value                 Enter how many time you want to count down(format: 00:00:00)
   --disable-hour value, --dh value       Disable hour(true or false)
   --colon-color value, --cc value        Set the colon color 
   --help, -h                             show help

Example

You can set the timer time using two types

classic:

tmlshock timer -hr 1 -m 1 -s 1

lazy:

tmlshock timer -t 1:20:01

Setting

Color

You can use color codes (down below) or use color names

black
blue
cyan
dark-gray
green
light-green
light-blue
light-cyan
light-gray
light-magenta
light-red
light-yellow
magenta
light-red
light-yellow
magenta
red
white
yellow

Example:

tmlshock clock -c red

Colon-color

To use a custom colon color just enter -cc color

Example

tmlshock clock -cc color

Disable-second

To disable the second just enter -s false

Example

tmlshock clock -s false

Enable-date

To enable the date just enter -d true

Example

tmlshock clock -d true

Date-formate

To use a custom date format just enter -df 2006/02/01(YYYY/MM/DD)

Example

tmlshock clock -d true -df 2006/01/02 

(YYYY/DD/MM)

tmlshock clock -d true -df 02/01/2006

(MM/DD/YYYY)

Disable-hour

• This option only for stopwatch and timer

To use a custom date format just enter -dh true(YYYY/MM/DD)

Example

tmlshock stopwatch -dh true

12-hours-format

• This option only for clock

To use a custom date format just enter -hf 12(YYYY/MM/DD)

Example

tmlshock clock -hf 12