https://github.com/mathialo/timer
Command line utility for taking time
https://github.com/mathialo/timer
cli command-line productivity python timer timetracking
Last synced: about 1 year ago
JSON representation
Command line utility for taking time
- Host: GitHub
- URL: https://github.com/mathialo/timer
- Owner: mathialo
- License: mit
- Created: 2017-09-23T21:30:21.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-11-12T20:09:27.000Z (over 8 years ago)
- Last Synced: 2025-01-12T17:38:36.305Z (about 1 year ago)
- Topics: cli, command-line, productivity, python, timer, timetracking
- Language: Python
- Homepage:
- Size: 7.81 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Timer
Command line utility for taking time. Stores timestamps as a file in the user's home directory, so that no program is running in the background.
### Requirements and installation
Timer is written in Python 3. To install, copy timer.py to a suitable directory, and make sure it's executable:
``` bash
$ chmod +x timer.py
```
now create a symlink to it from one of the bin-directories so that it's available from the command line:
``` bash
$ ln -s /link/to/timer.py /usr/local/bin/timer
```
Now, Timer should be installed. Try writing:
``` bash
$ timer start
$ timer stop
```
for confimation.
### Usage
Once installed, the following commands are available:
| Command | Discription |
| :---------: | ------------------------------------------------------- |
| `timer start` | Starts the timer |
| `timer stop` | Stops the timer and displays the time passed |
| `timer pause` | Pauses the timer |
| `timer resume` | Resumes the timer after a `timer pause` |
| `timer show` | Shows the current time passed (without stopping the timer) |
| `timer status` | Shows the current state of the timer (stopped, going or paused) |