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 |
- Download Version 1.1 or Latest Source
pip install .
- Check Python Packaging User Guide
pip install clox==1.1
ℹ️ You can use clox or python -m clox to run this program
clox --versionclox --infoℹ️ Press Ctrl + C to exit
cloxclox --face=3- Use
--face=-1for random mode - Faces List:
clox --faces-list
clox --timezone="Etc/GMT+7"- Timezones List:
clox --timezones-list
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
ℹ️ The vertical and horizontal shift both have default values of 0
clox --v-shift=20 --h-shift=30Disable blinking mode
clox --no-blinkIn this mode, the date will not be shown
clox --hide-dateIn this mode, the timezone will not be shown
clox --hide-timezoneIn this mode, the clock will be displayed in 12-hour format
clox --am-pmclox --verticalIn this mode, the calendar will be displayed
ℹ️ Valid choices: [MONTH, YEAR]
clox --calendar=month --first-weekday="SUNDAY"ℹ️ Valid choices: [GREGORIAN, JALALI]
ℹ️ The default date system is GREGORIAN
clox --date-system=jalaliℹ️ 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
Just fill an issue and describe it. We'll check it ASAP!
- Please complete the issue template
Give a ⭐️ if this project helped you!
1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy 0xcD4Db18B6664A9662123D4307B074aE968535388 Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7 rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef 0xcD4Db18B6664A9662123D4307B074aE968535388 Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5