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 |
pip install .pip install clox==1.1ℹ️ You can use clox or python -m clox to run this program
clox --version
clox --info
ℹ️ Press Ctrl + C to exit
clox
clox --face=3
--face=-1 for random modeclox --faces-listclox --timezone="Etc/GMT+7"
clox --timezones-listThe --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"
clox --countries-listℹ️ The vertical and horizontal shift both have default values of 0
clox --v-shift=20 --h-shift=30
Disable blinking mode
clox --no-blink
In this mode, the date will not be shown
clox --hide-date
In this mode, the timezone will not be shown
clox --hide-timezone
In this mode, the clock will be displayed in 12-hour format
clox --am-pm
clox --vertical
In 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
clox --date-formats-list
Just fill an issue and describe it. We'll check it ASAP!
Give a ⭐️ if this project helped you!
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
--first-weekday argument--date-format argument--date-formats-list argumentREADME.md updatedclox_info function modifiedrun_clock function modifiedPython 3.6 support dropped--country argument--countries-list argumentCOUNTRIES.mdREADME.md updated--date-system argumentREADME.md updated--calendar argumentREADME.md updated--hide-date argument--hide-timezone argument--am-pm argumentREADME.md updated--info argument--vertical argumentshow_faces_list function updatedAUTHORS.md updated--no-blink argumentREADME.md updated--v-shift and --h-shift arguments--timezone argument--face argumentrun_clock and main functionsTIMEZONES.mdFACES.mdFAQs
A Geeky Clock for Terminal Enthusiasts
We found that clox demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
The EU Cyber Resilience Act is prompting compliance requests that open source maintainers may not be obligated or equipped to handle.
Security News
Crates.io adds Trusted Publishing support, enabling secure GitHub Actions-based crate releases without long-lived API tokens.
Research
/Security News
Undocumented protestware found in 28 npm packages disrupts UI for Russian-language users visiting Russian and Belarusian domains.