https://github.com/vimist/termtime
A command line utility to manage and display time related tasks in the terminal.
https://github.com/vimist/termtime
Last synced: 5 months ago
JSON representation
A command line utility to manage and display time related tasks in the terminal.
- Host: GitHub
- URL: https://github.com/vimist/termtime
- Owner: vimist
- Created: 2019-04-13T13:59:37.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2020-06-02T11:32:30.000Z (about 6 years ago)
- Last Synced: 2025-09-25T06:24:32.854Z (9 months ago)
- Language: Python
- Size: 15.6 KB
- Stars: 5
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TermTime
A command line utility to manage and display time related tasks in the terminal:
- Display a live 24 hour clock
- Start a live stopwatch
- Start a countdown timer
## Installation
```
pip install termtime
```
## Example
Gaps between lines are typically smaller in the terminal, so the below is
usually displayed much clearer.
```
▄▄▄▄ ▄ ▄ ▄▄▄▄ ▄▄▄▄ ▄ ▄ ▄ ▄ ▄ ▄▄▄▄
█ █ █ █ ▄ █ █ ▄ █ █ █ █ ▀█ █ █
█ █ █▄▄█ ▀▀█ ▀▀▀█ █▄▄█ █▄▄█ █ █ █
█ █ █ ▀ █ █ ▀ █ █ █ █ █
▀▀▀▀ ▀ ▀▀▀▀ ▀▀▀▀ ▀ ▀ ▀ ▀▀▀ ▀▀▀▀
```
Automatically scales to the size of the screen!
```
█▀█ █ █ ▄ ▀▀█ █▀▀ ▄ █ █ █▀█ ▄█ █▀█
█ █ █▄█ ▀█ ▀▀█ █▄█ █▀█ █ █▀█
█▄█ █ ▀ ▄▄█ ▄▄█ ▀ █ █▄█ ▄ ▄█▄ █▄█
```
# Usage
```
usage: termtime [-h] [-f {default}] [--max-width MAX_WIDTH]
[--max-height MAX_HEIGHT]
{stopwatch,clock,countdown} ...
positional arguments:
{stopwatch,clock,countdown} Modes that termtime supports.
optional arguments:
-h, --help show this help message and exit
-f {default}, --font {default}
The font to use to render the output.
--max-width MAX_WIDTH
The maximum width of the output.
--max-height MAX_HEIGHT
The maximum height of the output.
```
# Extendable
- Easily create your own fonts to change the style of the output.
- Create new modes and contribute them back to the project to extend the
functionality of TermTime.