exclock is a cui extended timer.
Project description
exclock is a cui extended timer.
Required
vlc
xmessage or terminal-notifier(If you use mac, I recommend terminal-notifier)
How to install
$ pip install exclock
Usage
$ exclock [options] {clock-filename}
Features
Sound an alarm at a specified time.
Sound the alarm after the specified time has elapsed.
You can flexibly set the alarm.
Options
–version: show program’s version number and exit
-h, –help: show this help message and exit
-l, –list: show clock names in your PC and exit
-t, –time: Time which spends until or to specified
-r, –ring-filename: Sound-filename which used for ringing with -t, –time option. Note that you can use EXCLOCK_RING_FILENAME system variable if you often indicate ring-filename option.
–trace, –traceback: show traceback
How to sound an alarm at a specified time
Enter
$ exclock -t {time}
format command.
Where time is given in the {hour}:{min} or {hour}:{min}:{sec} format.
Ex.
$ exclock -t "1:00" $ exclock -t "1:00:20"
How to sound the alarm after the specified time has elapsed
Enter
$ exclock -t {time}
format command.
Where time is given in the {sec}, {sec}s, {min}m or {min}m{sec}s.
Ex.
$ exclock -t 3 $ exclock -t 3s $ exclock -t 2m $ exclock -t 2m3s
How to flexibly set the alarm
Enter
$ exclock {clock-filename}
format command. Although {clock-filename} can be omitted as descrived below.
clock-file should be a file in json5 format.
Official page for json5 format is Here.
clock file format
{
"title": "title(optional)",
"sounds": {
"time1": {
"message": "message1",
"sound_filename": "sound_filename1",
},
"time2":{
"message": "message2",
"sound_filename": "sound_filename2",
},
...
},
"loop": loop_number(optional)
}
title(Optional): string which be used for notification. Then the property is computed from clock-filename if this option is not indicated.
sounds: dictionary from time to dictionary which includes message and sound_filename.
time format is “{sec}”, “{sec}s”, “{min}m” or “{min}m{sec}s” format.
message is a string which be used for notification and terminal output. Then message is replaced by “{count}” to number of how many times execute.
sound_filename is a string which be used for play the sound.
loop(Option): number of iterations for above clock timer. If this is nil, this means repeatation a number of times. Default value is 1.
There are sample files in sample dir in gitlab.
How to omit clock filename
Clock filename can be omitted for some case.
Rules are
If extension of clock filename is .json5, extension can be omitted(ex: pomodoro.json5 => pomodoro).
If dir is in the specified directory(~/.config/exclock/clock/ or environment variable EXCLOCK_CLOCK_DIR), dir is omitted (ex: ~/.config/exclock/clock/abc.json5 => abc).
Buitin clock file can be accessed. There are in sample dir in gitlab (ex: 3m or pomodoro).
How to omit sound filename
Sound filename can be omitted for some case.
Rules are
If dir is in the specified directory(~/.config/exclock/sound/ or environment variable EXCLOCK_SOUND_DIR), dir is omitted (ex: ~/.config/exclock/sound/abc.mp3 => abc.mp3).
Buitin sound file can be accessed. There are in sample sound dir in gitlab (ex: silent.mp3 or warning.mp3).
LICENSE
Todo
[ ] add tests to main function
[x] split main function
[x] default value of loop to 1
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file exclock-0.2.5.tar.gz.
File metadata
- Download URL: exclock-0.2.5.tar.gz
- Upload date:
- Size: 69.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.0.9 CPython/3.7.0 Darwin/19.3.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 86657aaee6db69281bfb7f1759e700e1a26dba9de7b7eff4ad58002b6cef027f |
|
| MD5 | 78fb35b032c745decfcddbfccaedc710 |
|
| BLAKE2b-256 | 4c3a9e9ca36b6b84c7ca73736b9b7979b799fe54c35530471b590ed586d19536 |
File details
Details for the file exclock-0.2.5-py3-none-any.whl.
File metadata
- Download URL: exclock-0.2.5-py3-none-any.whl
- Upload date:
- Size: 69.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.0.9 CPython/3.7.0 Darwin/19.3.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b4e98436c14867e0af09872f62e6e07cdf32b140a833c9d10c1dbe42c6076032 |
|
| MD5 | a68ff45f093119015ead9d3708f534cb |
|
| BLAKE2b-256 | 547433a717efb0ca507085fc0b63f3505f7767998d2691490d4d9117bec16bd1 |
