pyoklock

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 14)

pyoklock : python cli digital clock.

pyoklock Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# pyoklock
python cli clock. Display digital clock on terminal.

![screenshot](https://github.com/6syun9/pyoklock/blob/master/images/screenshot.png?raw=true)

# Usage

## install
```
# require ptk 3.x : https://github.com/prompt-toolkit/python-prompt-toolkit
pip install pyoklock
```

## args: second
If you want display `second`, add `-s` or `--second` to the argument.
```
pyoklock -s
```

## args: frame
If you want display clock frame, add `-f` or `--frame` to the argument.
```
pyoklock -f
```
![screenshot](https://github.com/6syun9/pyoklock/blob/master/images/frame.png?raw=true)

## args: google_calender

If you want display Google Calender's moost recent event, add `-g` or `--google_calender` to the argument.
To use this args, you must get `Google API OAuth Client credentails`. 
If you got `credentails`, put it at `~/.pyoklock/` with the name `credentails.json`

OAuth Client credentails from: https://console.cloud.google.com/
```
mkdir ~/.pyoklock
mv [[your credentail path]] ~/.pyoklock/credentials.json
```

Then run pyoklock.
```
pyoklock -g
```

![screenshot](https://github.com/6syun9/pyoklock/blob/master/images/google_calender.png?raw=true)

If you want to delete the cache, remove `~/.pyoklock/token.pickle`.

### print event num
If you want to limit the number of events, using `--events` args.  
for example:
```
pyoklock -g --events 5
```
  
### event today only
If you want to put `event of today only`, using `-t` or `--today` args.  
for example:
```
pyoklock -g -t --events 10
```

### change the color
If you want to change the color according to the time, using `-c` or `--color` args. It's function for alert.
 - google calender events
    - 5 minutes ago: Red
    - within 15 minutes: Green

![screenshot](https://github.com/6syun9/pyoklock/blob/master/images/color.png?raw=true)

## args: model

If you want to change clock size, add `--model` to the argument.  
Selectable numbers are {0,1,2}. default is 1.  
for example:
```
pyoklock -f -s --model 0
```
![screenshot](https://github.com/6syun9/pyoklock/blob/master/images/models.png?raw=true)

## change digit character

If you want to change clock's character, set `$PYOKLOCK_BACK_CHAR` or `$PYOKLOCK_DIGIT_CHAR` to OS environment.  
for example:
```
export PYOKLOCK_BACK_CHAR="@"
export PYOKLOCK_DIGIT_CHAR=" "
pyoklock -s
```
![screenshot](https://github.com/6syun9/pyoklock/blob/master/images/char.png?raw=true)

# Special thanks to
 - [python prompt-toolkit](https://github.com/prompt-toolkit/python-prompt-toolkit) : pyoklock made by this cli tools.

# License
This software is released under the MIT License, see LICENSE.txt.

# Why PyOkLock?

python clock. -> pyoklock  
This is the same way as the artist " [ONE OK ROCK](http://www.oneokrock.com) "  I respect.

pyoklock

pyoklock Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

pyoklock

pyoklock Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README