Skip to content
/ TClock Public

A clock that runs in terminal, it may need to be modified to fill the screen/terminal emulator.

License

Notifications You must be signed in to change notification settings

Haz001/TClock

Repository files navigation

TClock

 _______ _____ _            _
|__   __/ ____| |          | |
   | | | |    | | ___   ___| | __
   | | | |    | |/ _ \ / __| |/ /
   | | | |____| | (_) | (__|   <
   |_|  \_____|_|\___/ \___|_|\_\
The Terminal Clock
MIT License
Copyright (c) 2019 Haz001

Version 1.3

A large digital clock that runs in a terminal.
This clock has two main animation methords:

  • Flash - Clears the screen.
  • Scroll - The new times scrolls up from beneath.

ToDo

  • Displays time

  • CLI menu

  • Single argument management

  • Help

  • Saving Settings

  • Multi argument management

  • Uptime mode

  • Revamp CLI and Draw processes

    • Make it Windows compatible
    • Make it more advanced to allow more effects and stuff.
  • Add Curses Draw as an option to see the time

    • this will allow different aligned text and cooler effects like dissolve and wipe effects
  • Man file

    • for Unix and Unix-Like (Linux) users to be able to get a manual.
  • uptime mode to display uptime

  • One Instance option tclock -i

    • Quickly get the time
  • Write out to file, so you don't have to use tclock -i >> filename

  • Multiple types of frames

  • Mutliple font sizes, small, medium and large

  • Count down, takes a date and counts down to it

  • Graphical Mode

35.7%

Help

_______ _____ _            _
|__   __/ ____| |          | |
  | | | |    | | ___   ___| | __
  | | | |    | |/ _ \ / __| |/ /
  | | | |____| | (_) | (__|   <
  |_|  \_____|_|\___/ \___|_|\_\
The Terminal Clock
MIT License
Copyright (c) 2019 Haz001

Usage: tclock [OPTION] [FILE, DATE]...

no option           Default settings
-h, --help          Help Menu
-m, --menu          CLI Menu
-G, --git           GitHub Link
-i, --inst          One Instance (draws, through print and closes)
In Development
-w [FILE]           Write out to file [InDevelopment]
-c [DATE]           Count Down to that date [InDevelopment]
-g                  Graphical Mode [InDevelopment]

Requirements

Minimum

  • Width - 56 characters
  • Heights - 15 characters
  • python3.6 installed
  • 97 KiB free
  • 64 MiB of RAM free

Recomended (been tested on)

  • Width - 56 characters
  • Heights - 15 characters
  • Python3.7.5 installed
  • 1 MiB free
  • 1 GiB of RAM free
  • GNU/Linux

Screenshots

Menu

Flash

Scroll options

Scroll animation in effect

Invert

How to get the most out of this clock:

Unix and Unix like Systems

  1. Press CTRL + ALT + F3 to enter into terminal mode and login
  • To return to your normal GUI life just press:
    • CTRL + ALT + F2 for GDM3
    • CTRL + ALT + F7 for LightDM
      If you don't know what display manager you are just press F1 to F7 with CTRL + ALT held down.
  1. Go into the Menu and customize your clock
  • If you installed it use the command tclock -m
  • If you cloned the git repo cd into src directory and then type python3 tclock.py -m
  1. Use the CLI menu to customize your clock
  2. Go to the main menu and enter into either Flash or Scroll to see your customized clock display the time.
  3. Watch the time pass by second by second for either a few seconds or a few days or years