PyClock 1.0.0
A digital clock for the terminal
License: MIT
Keywords: terminal,clock

PyClock
=======

What
~~~~

A simple digital clock for the terminal

Run
~~~

::

    python pyclock.py

Controls
~~~~~~~~

+------------------------------------+-----------------------------+
| Keys                               | Actions                     |
+====================================+=============================+
| ``q`` or ``Q`` or ``Esc``          | quit                        |
+------------------------------------+-----------------------------+
| ``s`` or ``S``                     | toggle seconds              |
+------------------------------------+-----------------------------+
| ``p`` or ``P``                     | toggle punctuation          |
+------------------------------------+-----------------------------+
| ``c`` or ``C``                     | toggle center display       |
+------------------------------------+-----------------------------+
| ``a`` or ``A``                     | toggle auto scale display   |
+------------------------------------+-----------------------------+
| ``0`` to ``9``                     | change color                |
+------------------------------------+-----------------------------+
| ``<`` or ``,``                     | decrease width              |
+------------------------------------+-----------------------------+
| ``>`` or ``.``                     | increase width              |
+------------------------------------+-----------------------------+
| ``[`` or ``{``                     | decrease height             |
+------------------------------------+-----------------------------+
| ``]`` or ``}``                     | increase height             |
+------------------------------------+-----------------------------+
| ``-`` or ``_``                     | change color down           |
+------------------------------------+-----------------------------+
| ``-`` or ``+``                     | change color up             |
+------------------------------------+-----------------------------+
| ````` or ``~``                     | random color                |
+------------------------------------+-----------------------------+
 
Command-line options
~~~~~~~~~~~~~~~~~~~~

+----------------------------------------+---------------------------------+
| Options                                | Descriptions                    |
+========================================+=================================+
| ``-h`` or ``--help``                   | show help message               |
+----------------------------------------+---------------------------------+
| ``-S`` or ``--no-seconds``             | do not display seconds          |
+----------------------------------------+---------------------------------+
| ``-s`` or ``--seconds``                | display seconds                 |
+----------------------------------------+---------------------------------+
| ``-P`` or ``--no-punctuation``         | do not display punctuation      |
+----------------------------------------+---------------------------------+
| ``-p`` or ``--punctuation``            | display punctuation             |
+----------------------------------------+---------------------------------+
| ``-C`` or ``--no-center``              | do not center clock display     |
+----------------------------------------+---------------------------------+
| ``-c`` or ``--center``                 | center clock display            |
+----------------------------------------+---------------------------------+
| ``-A`` or ``--no-auto-scale``          | do not auto scale display       |
+----------------------------------------+---------------------------------+
| ``-a`` or ``--auto-scale``             | auto scale display              |
+----------------------------------------+---------------------------------+
| ``-k COLOR`` or ``--color COLOR``      | color 0-255 (default: 2)        |
+----------------------------------------+---------------------------------+
| ``-f FORMAT`` or ``--format FORMAT``   | time format (default: %I%M%S)   |
+----------------------------------------+---------------------------------+
| ``-W WIDTH`` or ``--width WIDTH``      | scale width (default: 1)        |
+----------------------------------------+---------------------------------+
| ``-H HEIGHT`` or ``--height HEIGHT``   | scale height (default: 1)       |
+----------------------------------------+---------------------------------+

Configuration file
~~~~~~~~~~~~~~~~~~

Check out ``example.pyclock.conf`` for details.

Support
~~~~~~~

-  [x] Works on Linux completely

-  [x] Works on OSX completely

-  [ ] Windows not supported