Metadata-Version: 2.1
Name: darshellclock
Version: 1.1
Summary: Minimalist terminal digital clock
Home-page: https://github.com/darokin/darshell-clock
Author: Adrien Rebuzzi (darokin)
Author-email: darokin42@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
Requires-Dist: windows-curses (>=2.0) ; platform_system == "Windows"

# darshell-clock

![Python application](https://github.com/darokin/darshell-clock/workflows/Python%20application/badge.svg)
[![Build Status](https://travis-ci.com/darokin/darshell-clock.svg?branch=master)](https://travis-ci.com/darokin/darshell-clock)
![GitHub last commit](https://img.shields.io/github/last-commit/darokin/darshell-clock)
![Github last version](https://img.shields.io/github/v/release/darokin/darshell-clock?include_prereleases)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

**darshellclock** is a *MINIMALIST* console application to display time and date with nice ASCII digits in your terminal. Uses *curses*

Here is a demo but mostly you would use this in a small persistant terminal. (More on "why this project?" in the side notes at the end)

<p align="center"><img src="http://darokin.info/imgs/darshellclock.gif" alt="darshellclock demo"/></p>

## Features

Suitable for quite small terminal sizes.
Useful for having a clock sitting around if you use a tiling window manager or tmux for example.

 - Nice 'blocky' ASCII digits
 - Localised date format
 - 2 sizes of digits, smaller digits for smaller term
 - Autoresizing and centering
 - Color selection of the time or the date
 - Possibility to hide the date and/or the seconds
 - Autoclosing (if wanted, see arguments in 'Usage and keys')
 - All the parameters are saved upon exit


## Usage and keys

The usual arguments are here + a 'stop' argument for the autoclosing functionnality
```
-h --help        Show help
-v --version     Show version number
-i --info        Show info [ASCII ♥]
-s --stop STOP   Quit the application after <STOP> seconds
```
While in the app, use these keys to change the configuration :

| Key  | Purpose          
|------|--------------------
| h    | Show or hide help |
| q    | Quit              |
| z    | Change time color |
| x    | Change date color |
| d    | Show or hide date |
| s    | Show or hide secs |


## Installing and starting

Use Python 3.x

Install using pip:
```bash
 pip install darshellclock 	# installing
 darshellclock			# lauching
```
Or if you want to do it manually you can clone or downlad and extract the project:

```bash
$ git clone https://github.com/darokin/darshell-clock.git
$ cd darshell-clock 
$ python3 darshellclock           # to launch/test ; or you can install it :
$ python3 setup.py install --user # to install
$ darshellclock                   # to launch installed version
```


## Side notes

This program was mainly made to try out a whole life cycle of a simple python app and to grasp new skills around github/CI/python package distribution/etc.
The [discussion section](https://github.com/darokin/darshell-clock/discussions) is open if needed.

If you encounter any problem or have any suggestions, please [open an issue](https://github.com/darokin/darshell-clock/issues/new) or [send a pull request](https://github.com/darokin/darshell-clock/pulls).



