Skip to main content

exclock is a cui extended timer.

Project description

https://gitlab.com/yassu/exclock/badges/master/pipeline.svg https://gitlab.com/yassu/exclock/badges/master/coverage.svg

exclock is a cui extended timer.

Required

  • vlc

  • xmessage

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.

How to sound an alarm at a specified time

Enter

$ exclock -t {time}

format command.

Where time is given in the %H:%m or %H:%m:%S 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 %S, %Ss, %mm or %mm%ss.

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
}
  • title: string which be used for notification. This is the optional option. Then the property is computed from clock-filename.

  • 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.

    • sound_filename is a string which be used for play the sound.

  • loop: number of iterations for above clock timer. If this is nil, this means repeatation a number of times.

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(~/.exclock/clock/ or environment variable EXCLOCK_CLOCK_DIR), dir is omitted (ex: ~/.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(~/.exclock/sound/ or environment variable EXCLOCK_SOUND_DIR), dir is omitted (ex: ~/.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

Apache 2.0

Todo

  • [x] 環境にあるclock一覧を表示するコマンドを追加

  • Exception対応

    • [x] ‘Error: No available formula with the name “vlc“‘対応

    • [x] xmessageがない場合のエラー処理

  • [x] 指定された時間になったらタイマーを発火させるコマンドを追加

  • [x] 0病後にSoundが指定されていた場合 そのSoundのとき tqdmを使わない

  • [x] プログレスバーの出力をいい感じにする

  • [-] Add n variable

  • [x] secの変数名を_secというようにする

  • [x] KeyboardInteraptのエラー処理を書く

  • [x] 🐛 二つ同じ名前がなくても一つしか表示されないようにする

  • [x] 🎨 main関数のテストを追加

  • [-] is_bgm flag

  • [ ] poetry導入

  • [x] confirm_fの削除

  • [x] warningの音を設定できるような項目を追加する

  • [x] CLOCK_DIR_IN_SYSを指定できるような環境変数を定義する

  • [x] SOUND_DIR_IN_SYSを指定できるような環境変数を定義する

  • [x] setup.pyでPipenvのpackagesを使うようにする

  • [x] 真面目にdocumentを書く

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

exclock-0.1.10.tar.gz (74.4 kB view details)

Uploaded Source

Built Distribution

exclock-0.1.10-py3-none-any.whl (156.5 kB view details)

Uploaded Python 3

File details

Details for the file exclock-0.1.10.tar.gz.

File metadata

  • Download URL: exclock-0.1.10.tar.gz
  • Upload date:
  • Size: 74.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/46.4.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.3

File hashes

Hashes for exclock-0.1.10.tar.gz
Algorithm Hash digest
SHA256 65f9185e877042d33f8d15427d09195247861095ea0a95faebc821fe786244bc
MD5 ee26d1cf97fb1352eeac8fe1a322775a
BLAKE2b-256 613ea73cf76c6b50246fa057833284577097a582d8523fc4976856c002d23ed4

See more details on using hashes here.

File details

Details for the file exclock-0.1.10-py3-none-any.whl.

File metadata

  • Download URL: exclock-0.1.10-py3-none-any.whl
  • Upload date:
  • Size: 156.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/46.4.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.3

File hashes

Hashes for exclock-0.1.10-py3-none-any.whl
Algorithm Hash digest
SHA256 b2f5519a1550e86bb84611097dddc2a4e5c39deae5c7f2940f1fee88eab32586
MD5 e30d070047570198cd22e89cb3495a63
BLAKE2b-256 3ce39d12f4d92cf6ad252c4e9d7f6fb2e0ac3f05cb354c904abe77d0101488fd

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page