tomleo / ding

Lightweight time management CLI tool

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Ding Build Status

usage_gif

Tired of $ sleep 4231; beep? This is a very simple solution to help with short-term time management. The beep sound uses the motherboard audio, so it works even if your speakers are muted, but not if you muted the PC speakers πŸ˜› . Furthermore, it works wherever there's a Linux terminal, and that includes ssh sessions.

  • No dependencies other than Python itself πŸ’«
  • Install with pip or just copy the binary somewhere in $PATH ✨
  • Python2 and Python3 compatible 🌟
  • Around 100 LOC πŸ’₯
  • Runs on Linux, OS X, Windows, and maybe more πŸŽ‰

Installation

$ pip install ding-ding

(ding was taken)

Alternatively, download the ding.py file and run it however you please.

$ ./ding.py in 1s

Scenarios

  • You want to start work after browsing the news for a bit, but you don't want to get carried away and do no work. Set a timer for 15 minutes:
$ ding in 15m
  • You need to leave at 17:00 and you want to have time to get ready:
$ ding at 16:45
$ alias pomo="ding in 25m"
$ pomo

Example usage:

# Relative time
$ ding in 2m
$ ding in 2h 15m
$ ding in 2m 15s

# Absolute time
$ ding at 12
$ ding at 17:30
$ ding at 17:30:21

I don't hear anything

This happens when the audible bell was muted for your terminal or for your system. Enabling it differs between environments, so I would suggest trying out some Google searches on how to enable it. For a discussion on this, check this issue.

About

Lightweight time management CLI tool

License:MIT License


Languages

Language:Python 100.0%