{"id":35911296,"url":"https://github.com/nickotmazgin/linux-numeric-date-and-clock","last_synced_at":"2026-06-11T18:00:40.600Z","repository":{"id":311639495,"uuid":"1044271912","full_name":"nickotmazgin/Linux-Numeric-Date-And-Clock","owner":"nickotmazgin","description":"GNOME Shell top-bar clock: numeric DD/MM/YYYY, 24-hour time \u0026 seconds. Configurable strftime format. GNOME 45–50 (ESM). MIT.","archived":false,"fork":false,"pushed_at":"2026-06-09T09:38:44.000Z","size":3825,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-09T11:16:17.734Z","etag":null,"topics":["24-hour","clock","date","datetime","esm","gjs","gnome","gnome-46","gnome-shell","gnome-shell-extension","gtk","javascript","linux","numeric-date","open-source","panel","seconds","time","top-bar","wayland"],"latest_commit_sha":null,"homepage":"https://github.com/nickotmazgin/Linux-Numeric-Date-And-Clock/releases/latest","language":"JavaScript","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/nickotmazgin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":["https://www.paypal.com/donate/?hosted_button_id=4HM44VH47LSMW"]}},"created_at":"2025-08-25T12:42:18.000Z","updated_at":"2026-06-09T09:45:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"5dc923ca-9854-40f7-a82f-b2d7cd3c4682","html_url":"https://github.com/nickotmazgin/Linux-Numeric-Date-And-Clock","commit_stats":null,"previous_names":["nickotmazgin/linux-numeric-date-and-clock"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/nickotmazgin/Linux-Numeric-Date-And-Clock","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nickotmazgin%2FLinux-Numeric-Date-And-Clock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nickotmazgin%2FLinux-Numeric-Date-And-Clock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nickotmazgin%2FLinux-Numeric-Date-And-Clock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nickotmazgin%2FLinux-Numeric-Date-And-Clock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nickotmazgin","download_url":"https://codeload.github.com/nickotmazgin/Linux-Numeric-Date-And-Clock/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nickotmazgin%2FLinux-Numeric-Date-And-Clock/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34211067,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["24-hour","clock","date","datetime","esm","gjs","gnome","gnome-46","gnome-shell","gnome-shell-extension","gtk","javascript","linux","numeric-date","open-source","panel","seconds","time","top-bar","wayland"],"created_at":"2026-01-10T03:32:32.009Z","updated_at":"2026-06-11T18:00:40.586Z","avatar_url":"https://github.com/nickotmazgin.png","language":"JavaScript","funding_links":["https://www.paypal.com/donate/?hosted_button_id=4HM44VH47LSMW"],"categories":[],"sub_categories":[],"readme":"# Numeric Clock (GNOME Shell Extension)\n\n[![Release](https://img.shields.io/github/v/release/nickotmazgin/Linux-Numeric-Date-And-Clock?display_name=tag\u0026label=release)](https://github.com/nickotmazgin/Linux-Numeric-Date-And-Clock/releases/latest)\n[![CI](https://img.shields.io/github/actions/workflow/status/nickotmazgin/Linux-Numeric-Date-And-Clock/validate.yml?branch=main\u0026label=CI)](https://github.com/nickotmazgin/Linux-Numeric-Date-And-Clock/actions)\n[![Downloads](https://img.shields.io/github/downloads/nickotmazgin/Linux-Numeric-Date-And-Clock/total?label=downloads\u0026color=success)](https://github.com/nickotmazgin/Linux-Numeric-Date-And-Clock/releases)\n[![License: MIT](https://img.shields.io/github/license/nickotmazgin/Linux-Numeric-Date-And-Clock)](LICENSE)\n[![GNOME 45–50](https://img.shields.io/badge/GNOME-45%E2%80%9350-4A86CF?logo=gnome\u0026logoColor=white)](#compatibility)\n[![ESM](https://img.shields.io/badge/ESM-GJS%20modules-orange)](#compatibility)\n[![Wayland](https://img.shields.io/badge/Wayland-ready-0078D4)](#compatibility)\n\n[![Issues](https://img.shields.io/github/issues/nickotmazgin/Linux-Numeric-Date-And-Clock)](https://github.com/nickotmazgin/Linux-Numeric-Date-And-Clock/issues)\n[![Discussions](https://img.shields.io/github/discussions/nickotmazgin/Linux-Numeric-Date-And-Clock?label=discussions\u0026color=8B5CF6)](https://github.com/nickotmazgin/Linux-Numeric-Date-And-Clock/discussions)\n[![i18n](https://img.shields.io/badge/i18n-gettext-blue)](#features)\n[![PayPal](https://img.shields.io/badge/Donate-PayPal-0070BA?logo=paypal\u0026logoColor=white)](https://www.paypal.com/donate/?hosted_button_id=4HM44VH47LSMW)\n\nA lightweight GNOME Shell extension that replaces the top-bar clock with a **numeric, fully configurable** format — ideal for **DD/MM/YYYY**, **ISO 8601**, **24-hour**, or **12-hour** time with optional **seconds**, anywhere in the world.\n\n**Latest:** v17.4.2 — ESM build v26 for **GNOME 45–50** (Shell 46 tested on Zorin OS 18.1)\n\n\u003e Download only [v17.4.2](https://github.com/nickotmazgin/Linux-Numeric-Date-And-Clock/releases/latest). Older releases are kept for history and marked superseded.\n\n**UUID:** `numeric-clock@nickotmazgin`\n\n\u003e **Keywords:** GNOME clock · numeric date · DD/MM/YYYY · ISO 8601 · 24-hour time · international · top bar · Linux desktop · open source\n\n\u003e **GNOME Shell 42–44 is no longer supported.** Numeric Clock requires **GNOME 45–50**.\n\n---\n\n## Quick links\n\n* **Latest release (ZIPs):** [GitHub Releases](https://github.com/nickotmazgin/Linux-Numeric-Date-And-Clock/releases/latest)\n* **Privacy:** [PRIVACY.md](PRIVACY.md)\n* **Security:** [SECURITY.md](SECURITY.md)\n* **Issues:** [Report a bug](https://github.com/nickotmazgin/Linux-Numeric-Date-And-Clock/issues)\n* **Discussions:** [Ask a question](https://github.com/nickotmazgin/Linux-Numeric-Date-And-Clock/discussions)\n\n---\n\n## Screenshot\n\n![Numeric Clock — top bar, settings, and about (2026)](screenshots/collage-2026.png)\n\n---\n\n## Features\n\n* Fully numeric date/time — you choose the `strftime` **format string**\n* **International defaults:** `DD/MM/YYYY HH:MM:SS` (24-hour, seconds; uses your **system locale and timezone**)\n* **7 format presets:** International, weekday, compact, time-only, ISO 8601, US 12-hour, top-bar only\n* **Live preview** in settings — ticks every second when format shows seconds\n* Configurable **update interval** (1–300 seconds)\n* **Smooth second tick** alignment when showing seconds\n* **Panel access icon** — digital clock icon opens a quick menu (preferences, presets, copy time)\n* **Right-click the formatted clock** for the same quick menu (left-click still opens GNOME calendar)\n* **Restore default clock** when disabled or uninstalled\n* Safe plain-text rendering (no Pango markup)\n* No network access, telemetry, or external services — see [PRIVACY.md](PRIVACY.md)\n\n---\n\n## Compatibility\n\n| GNOME | Status | Extension version | Notes |\n| ----- | ------ | ----------------: | ----- |\n| **45–50** | **Supported** | 26 | ESM build; do not ship `schemas/gschemas.compiled` |\n| **42–44** | **Discontinued** | — | No longer built or maintained |\n\n**Minimum requirement:** GNOME Shell **45**.\n\nWorks on **Zorin OS**, Ubuntu, Fedora, and other GNOME-based distributions that ship Shell 45–50.\n\n---\n\n## Install\n\n### From GitHub release (recommended)\n\n```bash\ngnome-extensions install --force dist/numeric-clock@nickotmazgin.v26.shell-extension.zip\ngnome-extensions enable numeric-clock@nickotmazgin\ngnome-extensions prefs numeric-clock@nickotmazgin\n```\n\n### Build locally\n\n```bash\n./tools/build.sh\n./tools/validate.sh\ngnome-extensions install --force dist/numeric-clock@nickotmazgin.v26.shell-extension.zip\ngnome-extensions enable numeric-clock@nickotmazgin\n```\n\n\u003e **Note:** Release ZIPs **must not** contain `schemas/gschemas.compiled`.\n\nAfter install, restart GNOME Shell: **Alt+F2** → `r` → Enter (Xorg) or log out/in (Wayland).\n\n---\n\n## Usage\n\nOpen **Preferences** and set:\n\n* **Format string** — any `strftime` pattern\n* **Update interval (seconds)** — use `1` when showing seconds\n* **Smooth tick** — align updates to second boundaries\n* **Show panel access icon** — digital clock icon for quick menu\n* **Right-click clock for quick menu** — secondary/middle click on the formatted clock\n\nChanges apply immediately as you type.\n\n**Quick access:**\n\n* Click the **panel clock icon** (system tray area) for preferences, presets, and copy time\n* **Right-click** or **middle-click** the formatted top-bar clock for the same menu\n* **Left-click** the clock still opens the standard GNOME calendar\n\n### Regional examples\n\nNumeric Clock uses your **system timezone** — set it in OS Settings. Examples:\n\n**Europe / DD/MM (24-hour):**\n\n```bash\ngsettings set org.gnome.shell.extensions.numeric-clock format-string '%d/%m/%Y %H:%M:%S'\n```\n\n**ISO 8601 (worldwide standard):**\n\n```bash\ngsettings set org.gnome.shell.extensions.numeric-clock format-string '%Y-%m-%d %H:%M:%S'\n```\n\n**US (12-hour):**\n\n```bash\ngsettings set org.gnome.shell.extensions.numeric-clock format-string '%m/%d/%Y %I:%M:%S %p'\n```\n\nOr use the matching **preset buttons** in Preferences.\n\n### Quick `strftime` cheatsheet\n\n`%A` weekday · `%a` short weekday · `%d` day · `%m` month · `%Y` year · `%H` hour (00–23) · `%I` hour (01–12) · `%p` AM/PM · `%M` minute · `%S` second\n\nExamples:\n\n* `%d/%m/%Y %H:%M:%S` → `30/05/2026 18:20:06`\n* `%Y-%m-%d %H:%M:%S` → `2026-05-30 18:20:06`\n* `%m/%d/%Y %I:%M:%S %p` → `05/30/2026 06:20:06 PM`\n\n---\n\n## Troubleshooting\n\n**Clock missing or doubled?**\n\n```bash\ngnome-extensions list | grep -Ei 'clock|date|time'\ngnome-extensions disable \u003cconflicting-extension-uuid\u003e\n```\n\n**Reset preferences:**\n\n```bash\ngsettings reset-recursively org.gnome.shell.extensions.numeric-clock\n```\n\n**Check status:**\n\n```bash\ngnome-extensions info numeric-clock@nickotmazgin\ngnome-extensions list --enabled\n```\n\n**Logs:**\n\n```bash\njournalctl --user -b 0 -o cat | grep -i numeric-clock\n```\n\n---\n\n## Packaging \u0026 releases (maintainers)\n\n```bash\n./tools/build.sh    # -\u003e dist/numeric-clock@nickotmazgin.v26.shell-extension.zip (GNOME 45–50)\n./tools/validate.sh\n```\n\nTag `v*` to trigger CI upload of ZIPs to GitHub Releases.\n\nDo **not** commit `schemas/gschemas.compiled` to the repo.\n\n---\n\n## Privacy \u0026 compliance\n\n* **Privacy:** [PRIVACY.md](PRIVACY.md) — local-only, no network, no telemetry\n* **Security:** [SECURITY.md](SECURITY.md) — coordinated disclosure\n* **License:** MIT — see [LICENSE](LICENSE)\n\nThis extension modifies only the top-bar clock display via supported GNOME Shell APIs. It does not bypass security, escalate privileges, or access data outside your session.\n\n---\n\n## License\n\nMIT © Nick Otmazgin — see [LICENSE](LICENSE).\n\n---\n\n## Support\n\n[![PayPal](https://img.shields.io/badge/Donate-PayPal-0070BA?logo=paypal\u0026logoColor=white)](https://www.paypal.com/donate/?hosted_button_id=4HM44VH47LSMW)\n\n---\n\n## Contact\n\n[nickotmazgin.dev@gmail.com](mailto:nickotmazgin.dev@gmail.com)\n\n---\n\n## Credits \u0026 Acknowledgements\n\nNumeric Clock is created, maintained, signed, and released by **[Nick Otmazgin](https://github.com/nickotmazgin)** — the project's sole administrator and solo developer, who authors and reviews all code that ships.\n\n[![AI assisted — OpenAI Codex](https://img.shields.io/badge/AI%20assisted-OpenAI%20Codex-10A37F)](https://openai.com/codex/)\n[![AI assisted — Cursor Agent](https://img.shields.io/badge/AI%20assisted-Cursor%20Agent-1A1A1A)](https://cursor.com)\n\nRecent releases were built with help from AI pair-programming agents, operated under the maintainer's direction and review:\n\n- **OpenAI Codex** — release engineering, signed-tag release workflows, release validation and CI hardening\n- **Cursor (Agent)** — code review, debugging, documentation\n\nEvery AI-assisted change is human-reviewed, tested on real GNOME sessions, and approved by the maintainer before release. See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full credits.\n\n\u003e OpenAI and Codex are trademarks of OpenAI. Cursor is a trademark of Anysphere, Inc. These names are used here solely for factual attribution. Numeric Clock is an independent project and is **not** affiliated with, sponsored, or endorsed by OpenAI or Anysphere/Cursor.\n\n---\n\n## Find this project\n\n**GitHub topics:** `gnome-shell-extension` · `clock` · `24-hour` · `numeric-date` · `top-bar` · `seconds` · `wayland` · `linux` · `open-source`\n\n**Search for:** GNOME numeric clock, Linux top bar date format, DD/MM/YYYY clock extension, 24 hour clock GNOME\n\n## More GNOME extensions by Nick Otmazgin\n\n- [ClipFlow Pro](https://github.com/nickotmazgin/clipflow-pro) — clipboard history manager with pins, stars \u0026 privacy\n- [Comfort Control (EaseHub)](https://github.com/nickotmazgin/comfort-control-easehub) — panel menu for power, screenshots, updates \u0026 utilities\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnickotmazgin%2Flinux-numeric-date-and-clock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnickotmazgin%2Flinux-numeric-date-and-clock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnickotmazgin%2Flinux-numeric-date-and-clock/lists"}