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 0.7 or Latest Source
• pip install .

PyPI

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

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

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

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

Date System

ℹ️ Valid choices: [gregorian, jalali]

ℹ️ The default date system is gregorian

clox --date-system=jalali

Screen Record

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

Changelog

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.

Unreleased

0.7 - 2025-03-06

Added

• Jalali calendar
• --date-system argument

Changed

• README.md updated

0.6 - 2025-02-25

Added

• --calendar argument

Changed

• README.md updated

0.5 - 2025-02-14

Added

• --hide-date argument
• --hide-timezone argument
• --am-pm argument

Changed

• README.md updated

0.4 - 2025-01-18

Added

• Date
• --info argument

0.3 - 2025-01-10

Added

• Logo
• --vertical argument

Changed

• show_faces_list function updated
• AUTHORS.md updated

0.2 - 2025-01-01

Added

• Blink mode
• --no-blink argument

Changed

• README.md updated

0.1 - 2024-12-24

Added

• --v-shift and --h-shift arguments
• --timezone argument
• --face argument
• run_clock and main functions
• TIMEZONES.md
• FACES.md