{"id":27639464,"url":"https://github.com/sepandhaghighi/clox","last_synced_at":"2025-12-29T13:04:50.976Z","repository":{"id":269510810,"uuid":"893117117","full_name":"sepandhaghighi/clox","owner":"sepandhaghighi","description":"⏰ A Geeky Clock for Terminal Enthusiasts","archived":false,"fork":false,"pushed_at":"2025-05-23T06:19:11.000Z","size":376,"stargazers_count":45,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-24T03:04:08.860Z","etag":null,"topics":["ascii-art","cli","cli-app","clock","clockface","python","terminal","terminal-app","terminal-based","time","timer"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sepandhaghighi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":"https://github.com/sepandhaghighi/clox#show-your-support"}},"created_at":"2024-11-23T15:24:25.000Z","updated_at":"2025-06-21T17:56:10.000Z","dependencies_parsed_at":"2024-12-24T05:24:35.784Z","dependency_job_id":"35dc12fd-ebb3-48ff-8b7b-904d287e0851","html_url":"https://github.com/sepandhaghighi/clox","commit_stats":null,"previous_names":["sepandhaghighi/clox"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/sepandhaghighi/clox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sepandhaghighi%2Fclox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sepandhaghighi%2Fclox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sepandhaghighi%2Fclox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sepandhaghighi%2Fclox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sepandhaghighi","download_url":"https://codeload.github.com/sepandhaghighi/clox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sepandhaghighi%2Fclox/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263472279,"owners_count":23471812,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ascii-art","cli","cli-app","clock","clockface","python","terminal","terminal-app","terminal-based","time","timer"],"created_at":"2025-04-23T22:16:24.389Z","updated_at":"2025-12-29T13:04:50.970Z","avatar_url":"https://github.com/sepandhaghighi.png","language":"Python","funding_links":["https://github.com/sepandhaghighi/clox#show-your-support"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://github.com/sepandhaghighi/clox/raw/main/otherfiles/logo.png\" width=\"450\"\u003e\n\u003ch1\u003eClox: A Geeky Clock for Terminal Enthusiasts\u003c/h1\u003e\n\u003cbr/\u003e\n\u003ca href=\"https://badge.fury.io/py/clox\"\u003e\u003cimg src=\"https://badge.fury.io/py/clox.svg\" alt=\"PyPI version\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.python.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/built%20with-Python3-green.svg\" alt=\"built with Python3\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/sepandhaghighi/clox\"\u003e\u003cimg alt=\"GitHub repo size\" src=\"https://img.shields.io/github/repo-size/sepandhaghighi/clox\"\u003e\u003c/a\u003e\n\u003c/div\u003e\t\t\t\n\t\t\t\t\n## Overview\t\n\n\u003cp align=\"justify\"\u003e\t\t\t\t\t\nClox 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.\n\u003c/p\u003e\n\n\u003ctable\u003e\n\t\u003ctr\u003e\n\t\t\u003ctd align=\"center\"\u003ePyPI Counter\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003ca href=\"http://pepy.tech/project/clox\"\u003e\u003cimg src=\"http://pepy.tech/badge/clox\"\u003e\u003c/a\u003e\u003c/td\u003e\n\t\u003c/tr\u003e\n\t\u003ctr\u003e\n\t\t\u003ctd align=\"center\"\u003eGithub Stars\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/sepandhaghighi/clox\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/sepandhaghighi/clox.svg?style=social\u0026label=Stars\"\u003e\u003c/a\u003e\u003c/td\u003e\n\t\u003c/tr\u003e\n\u003c/table\u003e\n\n\n\n\u003ctable\u003e\n\t\u003ctr\u003e \n\t\t\u003ctd align=\"center\"\u003eBranch\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003emain\u003c/td\u003e\t\n\t\t\u003ctd align=\"center\"\u003edev\u003c/td\u003e\t\n\t\u003c/tr\u003e\n\t\u003ctr\u003e\n\t\t\u003ctd align=\"center\"\u003eCI\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003cimg src=\"https://github.com/sepandhaghighi/clox/actions/workflows/test.yml/badge.svg?branch=main\"\u003e\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003cimg src=\"https://github.com/sepandhaghighi/clox/actions/workflows/test.yml/badge.svg?branch=dev\"\u003e\u003c/td\u003e\n\t\u003c/tr\u003e\n\u003c/table\u003e\n\n\n\u003ctable\u003e\n\t\u003ctr\u003e \n\t\t\u003ctd align=\"center\"\u003eCode Quality\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003ca href=\"https://www.codefactor.io/repository/github/sepandhaghighi/clox\"\u003e\u003cimg src=\"https://www.codefactor.io/repository/github/sepandhaghighi/clox/badge\" alt=\"CodeFactor\"\u003e\u003c/a\u003e\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003ca href=\"https://app.codacy.com/gh/sepandhaghighi/clox/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade\"\u003e\u003cimg src=\"https://app.codacy.com/project/badge/Grade/4cd4cd3b20b1474fb674823b1b417b76\"\u003e\u003c/a\u003e\u003c/td\u003e\n\t\u003c/tr\u003e\n\u003c/table\u003e\n\n\n## Installation\t\t\n\n### Source Code\n- Download [Version 1.5](https://github.com/sepandhaghighi/clox/archive/v1.5.zip) or [Latest Source](https://github.com/sepandhaghighi/clox/archive/dev.zip)\n- `pip install .`\t\t\t\t\n\n### PyPI\n\n- Check [Python Packaging User Guide](https://packaging.python.org/installing/)     \n- `pip install clox==1.5`\t\t\t\t\t\t\n\n\n## Usage\n\nℹ️ You can use `clox` or `python -m clox` to run this program\n\n### Version\n\n```console\nclox --version\n```\n\n### Info\n\n```console\nclox --info\n```\n\n### Basic\n\nℹ️ Press `Ctrl + C` to exit\n\n```console\nclox\n```\n\n### Face\n\n```console\nclox --face=3\n```\n* Use `--face=-1` for random mode\n* [Faces List](https://github.com/sepandhaghighi/clox/blob/main/FACES.md): `clox --faces-list`\n\n\n### Timezone\n\n```console\nclox --timezone=\"Etc/GMT+7\"\n```\n* [Timezones List](https://github.com/sepandhaghighi/clox/blob/main/TIMEZONES.md): `clox --timezones-list`\n\n\n### Manual Offset\n\nℹ️ The local and timezone offset both have default values of `0`\n\nThese 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.\n\n```console\nclox --offset-local=1 --offset-timezone=-1\n```\n\n### Country\n\nThe `--country` argument allows you to specify a country using its **ISO 3166** code format\n\nℹ️ When the `--country` argument is provided, the `--timezone` argument will be ignored\n\nℹ️ If the specified country has multiple timezones, the first timezone will be selected automatically\n\n```console\nclox --country=\"DE\"\n```\n* [Countries List](https://github.com/sepandhaghighi/clox/blob/main/COUNTRIES.md): `clox --countries-list`\n\n\n### Vertical/Horizontal Shift\n\nℹ️ The vertical and horizontal shift both have default values of `0`\n\n```console\nclox --v-shift=20 --h-shift=30\n```\n\n### No Blink\n\nDisable blinking mode\n\n```console\nclox --no-blink\n```\n\n### Once\n\nPrint current time once and exit immediately\n\n```console\nclox --once\n```\n\n### Hide Date\n\nIn this mode, the date will not be shown\n\n```console\nclox --hide-date\n```\n\n### Hide Timezone\n\nIn this mode, the timezone will not be shown\n\n```console\nclox --hide-timezone\n```\n\n### AM/PM Mode\n\nIn this mode, the clock will be displayed in 12-hour format\n\n```console\nclox --am-pm\n```\n\n### Vertical Mode\n\n```console\nclox --vertical\n```\n\n### Calendar Mode\n\nIn this mode, the calendar will be displayed\n\nℹ️ Valid choices: [`MONTH`, `YEAR`]\n\n```console\nclox --calendar=month --first-weekday=\"SUNDAY\"\n```\n\n### Date System\n\nℹ️ Valid choices: [`GREGORIAN`, `JALALI`]\n\nℹ️ The default date system is `GREGORIAN`\n\n```console\nclox --date-system=jalali\n```\n\n### Date Format\n\nℹ️ Valid choices: [`ISO`, `US`, `US-SHORT`, `EU`, `EU-SHORT`, `DOT`, `DASH`, `YMD`, `DMY`, `MDY`, `FULL`]\n\nℹ️ The default date format is `FULL`\n\n```console\nclox --date-system=jalali --date-format=EU\n```\n* Date Formats List: `clox --date-formats-list`\n\n### Color\n\n⚠️ This mode may not be supported on all systems\n\nℹ️ Valid choices: [`BLACK`, `RED`, `GREEN`, `YELLOW`, `BLUE`, `MAGENTA`, `CYAN`, `WHITE`, `LIGHTBLACK`, `LIGHTRED`, `LIGHTGREEN`, `LIGHTYELLOW`, `LIGHTBLUE`, `LIGHTMAGENTA`, `LIGHTCYAN`, `LIGHTWHITE`]\n\nℹ️ The default color is `WHITE`\n\n```console\nclox --date-system=jalali --color=\"red\"\n```\n\n### Background Color\n\n⚠️ This mode may not be supported on all systems\n\nℹ️ Valid choices: [`BLACK`, `RED`, `GREEN`, `YELLOW`, `BLUE`, `MAGENTA`, `CYAN`, `WHITE`, `LIGHTBLACK`, `LIGHTRED`, `LIGHTGREEN`, `LIGHTYELLOW`, `LIGHTBLUE`, `LIGHTMAGENTA`, `LIGHTCYAN`, `LIGHTWHITE`]\n\nℹ️ The default background color is `BLACK`\n\n```console\nclox --date-system=jalali --color=\"red\" --bg-color=\"blue\"\n```\n\n### Intensity\n\n⚠️ This mode may not be supported on all systems\n\nℹ️ Valid choices: [`NORMAL`, `BRIGHT`, `DIM`]\n\nℹ️ The default intensity is `NORMAL`\n\n```console\nclox --color=\"red\" --intensity=\"bright\"\n```\n\n## Screen Record\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://github.com/sepandhaghighi/clox/raw/main/otherfiles/help.gif\"\u003e\n\n\u003c/div\u003e\n\n## Try Clox Online!\n\nClox can be used online in interactive Jupyter Notebooks via the Binder or Colab services! Try it out now! :\n\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/sepandhaghighi/clox/main)\n\n[![Google Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/sepandhaghighi/clox/blob/main)\n\n- Open `notebook.ipynb`\n\n## Issues \u0026 Bug Reports\t\t\t\n\nJust fill an issue and describe it. We'll check it ASAP!\n\n- Please complete the issue template\n \t\t\t\n\n## Show Your Support\n\t\t\t\t\t\t\t\t\n\u003ch3\u003eStar This Repo\u003c/h3\u003e\t\t\t\t\t\n\nGive a ⭐️ if this project helped you!\n\n\u003ch3\u003eDonate to Our Project\u003c/h3\u003e\t\n\n\u003ch4\u003eBitcoin\u003c/h4\u003e\n1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy\n\u003ch4\u003eEthereum\u003c/h4\u003e\n0xcD4Db18B6664A9662123D4307B074aE968535388\n\u003ch4\u003eLitecoin\u003c/h4\u003e\nLdnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ\n\u003ch4\u003eDoge\u003c/h4\u003e\nDDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh\n\u003ch4\u003eTron\u003c/h4\u003e\nTCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7\n\u003ch4\u003eRipple\u003c/h4\u003e\nrN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq\n\u003ch4\u003eBinance Coin\u003c/h4\u003e\nbnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef\n\u003ch4\u003eTether\u003c/h4\u003e\n0xcD4Db18B6664A9662123D4307B074aE968535388\n\u003ch4\u003eDash\u003c/h4\u003e\nXd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s\n\u003ch4\u003eStellar\u003c/h4\u003e\t\t\nGALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL\n\u003ch4\u003eZilliqa\u003c/h4\u003e\nzil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5\n\u003ch4\u003eCoffeete\u003c/h4\u003e\n\u003ca href=\"http://www.coffeete.ir/opensource\"\u003e\n\u003cimg src=\"http://www.coffeete.ir/images/buttons/lemonchiffon.png\" style=\"width:260px;\" /\u003e\n\u003c/a\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsepandhaghighi%2Fclox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsepandhaghighi%2Fclox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsepandhaghighi%2Fclox/lists"}