Overview

Clox is a terminal-based clock application designed for terminal enthusiasts who appreciate simplicity, elegance, and productivity within their command-line environment. Whether you're coding, monitoring tasks, or simply enjoying the terminal aesthetic, Clox brings a stylish and customizable time display to your workspace.

PyPI Counter
Github Stars

Branch	main	dev
CI

Code Quality

Installation

Source Code

• Download Version 1.6 or Latest Source
• pip install .

PyPI

• Check Python Packaging User Guide
• pip install clox==1.6

Usage

ℹ️ You can use clox or python -m clox to run this program

Version

clox --version

Info

clox --info

Basic

ℹ️ Press Ctrl + C to exit

clox

Face

clox --face=3

• Use --face=-1 for random mode
• Faces List: clox --faces-list

Timezone

clox --timezone="Etc/GMT+7"

• Timezones List: clox --timezones-list

Manual Offset

ℹ️ The local and timezone offset both have default values of 0

These arguments allow you to manually adjust the time by ±X hours. This is especially useful when daylight saving time (DST) is not correctly applied by the system or timezone database.

clox --offset-local=1 --offset-timezone=-1

Country

The --country argument allows you to specify a country using its ISO 3166 code format

ℹ️ When the --country argument is provided, the --timezone argument will be ignored

ℹ️ If the specified country has multiple timezones, the first timezone will be selected automatically

clox --country="DE"

• Countries List: clox --countries-list

Vertical/Horizontal Shift

ℹ️ The vertical and horizontal shift both have default values of 0

clox --v-shift=20 --h-shift=30

No Blink

Disable blinking mode

clox --no-blink

Once

Print current time once and exit immediately

clox --once

Hide Date

In this mode, the date will not be shown

clox --hide-date

Hide Timezone

In this mode, the timezone will not be shown

clox --hide-timezone

AM/PM Mode

In this mode, the clock will be displayed in 12-hour format

clox --am-pm

Vertical Mode

clox --vertical

Calendar Mode

In this mode, the calendar will be displayed

ℹ️ Valid choices: [MONTH, YEAR]

clox --calendar=month --first-weekday="SUNDAY"

Date System

ℹ️ Valid choices: [GREGORIAN, JALALI]

ℹ️ The default date system is GREGORIAN

clox --date-system=jalali

Date Format

ℹ️ Valid choices: [ISO, US, US-SHORT, EU, EU-SHORT, DOT, DASH, YMD, DMY, MDY, FULL]

ℹ️ The default date format is FULL

clox --date-system=jalali --date-format=EU

• Date Formats List: clox --date-formats-list

Color

⚠️ This mode may not be supported on all systems

ℹ️ Valid choices: [BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE, LIGHTBLACK, LIGHTRED, LIGHTGREEN, LIGHTYELLOW, LIGHTBLUE, LIGHTMAGENTA, LIGHTCYAN, LIGHTWHITE, RANDOM]

ℹ️ The default color is WHITE

clox --date-system=jalali --color="red"

Background Color

⚠️ This mode may not be supported on all systems

ℹ️ Valid choices: [BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE, LIGHTBLACK, LIGHTRED, LIGHTGREEN, LIGHTYELLOW, LIGHTBLUE, LIGHTMAGENTA, LIGHTCYAN, LIGHTWHITE, RANDOM]

ℹ️ The default background color is BLACK

clox --date-system=jalali --color="red" --bg-color="blue"

Intensity

⚠️ This mode may not be supported on all systems

ℹ️ Valid choices: [NORMAL, BRIGHT, DIM, RANDOM]

ℹ️ The default intensity is NORMAL

clox --color="red" --intensity="bright"

Screen Record

Try Clox Online!

Clox can be used online in interactive Jupyter Notebooks via the Binder or Colab services! Try it out now! :

• Open notebook.ipynb

Issues & Bug Reports

Just fill an issue and describe it. We'll check it ASAP!

• Please complete the issue template

Show Your Support

Star This Repo

Give a ⭐️ if this project helped you!

Donate to Our Project

Bitcoin

1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy

Ethereum

0xcD4Db18B6664A9662123D4307B074aE968535388

Litecoin

Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ

Doge

DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh

Tron

TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7

Ripple

rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq

Binance Coin

bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef

Tether

0xcD4Db18B6664A9662123D4307B074aE968535388

Dash

Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s

Stellar

GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL

Zilliqa

zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5

Coffeete