Package: exclock
Exclockexclock is a cui extended timer.Requiredmplayerxmessage or terminal-notifier(If you use mac, I recommend
terminal-notifier)How to install$ pip install exclockUsage$ exclock [options]FeaturesSound 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-c, --clock-name: set clock filename-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 tracebackHow to sound an alarm at a specified timeEnter$ 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 elapsedEnter$ 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 2m3sHow to flexibly set the alarmEnter$ exclock -c {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 isHere.clock file format{
  "title": "title(optional)",
  "sounds": {
    "time1": {
      "message": "message1",
      "sound_filename": "sound_filename1",
    },
    "time2":{
    "message": "message2",
    "sound_filename": "sound_filename2",
    },
    ...
  },
  "show_message": show_message(optional),
  "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.show_message(Option): bool of show_message using xmessage or terminal-notifierloop(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 insample dir in
gitlab.How to omit clock filenameClock filename can be omitted for some case.Rules areIf 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 insample dir in
gitlab(ex: 3m or pomodoro).How to omit sound filenameSound filename can be omitted for some case.Rules areIf 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 insample sound dir in
gitlab(ex: silent.mp3 or ring.mp3).LICENSEApache 2.0