Clox: A Geeky Clock for Terminal Enthusiasts

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

PyPI

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

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

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

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