Skip to content

A GNOME Shell extension that replaces the top-bar clock with a customizable numeric date and time format strings etc (DD/MM/YYYY HH:MM). Works on Wayland & Xorg, and users can modify the date/time formats strings etcetera and update intervals through the extension interface window or gsettings. Configurable to show the time in a 24-hour format.

License

Notifications You must be signed in to change notification settings

nickotmazgin/Linux-Numeric-Date-And-Clock

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Numeric Clock (GNOME Shell Extension)

A lightweight GNOME Shell extension that replaces the top-bar clock with a numeric, fully configurable format (e.g., DD/MM/YYYY HH:MM). Works on GNOME 42 → 45+ (Wayland & Xorg). Licensed under MIT.

UUID: numeric-clock@nickotmazgin E.G.O. page: https://extensions.gnome.org/extension/8566/numeric-clock/

Using GNOME 42–44? See the legacy/42-44 branch.


Quick links


Screenshot

Numeric Clock — top bar & preferences


Features

  • Fully numeric date/time (you choose the strftime format string).
  • Instant-apply preferences — changes apply as you type.
  • Configurable update interval (seconds).
  • Plays nice with other clocks (keeps visible labels in sync).
  • Safe text rendering (plain text; no Pango markup).
  • No network access, telemetry, or external services.

Compatibility & builds

Build (branch) GNOME Settings schema ID E.G.O “Extension version” Packaging notes
Main (main) 45+ org.gnome.shell.extensions.numeric-clock v7 Do not include schemas/gschemas.compiled. Metadata includes "icon": "icon.png".
Legacy (legacy/42-44) 42–44 org.gnome.shell.extensions.numeric-clock v12 Must include schemas/gschemas.compiled inside the ZIP.

On the E.G.O. page you can pick Shell version (42/43/44/45) and the matching Extension version (v12 for 42–44, v7 for 45+) from the dropdowns.


Install

A) From extensions.gnome.org (recommended)

  1. Open https://extensions.gnome.org/extension/8566/numeric-clock/

  2. In Download, set Shell version to your GNOME, then choose:

    • GNOME 45+ → Extension version v7
    • GNOME 42–44 → Extension version v12
  3. Click Install (with the browser integration), or download and install manually:

B) Manual install (ZIP)

# 45+
gnome-extensions install --force numeric-clock@nickotmazgin-gnome45-*.zip

# 42–44 (legacy)
gnome-extensions install --force numeric-clock@nickotmazgin-legacy-42-44-*.zip

# Enable + open preferences
gnome-extensions enable numeric-clock@nickotmazgin
gnome-extensions prefs  numeric-clock@nickotmazgin

Note: 45+ ZIPs must not contain schemas/gschemas.compiled. 42–44 ZIPs must contain schemas/gschemas.compiled.


Usage

Open Preferences and set:

  • Format string — any strftime pattern.
  • Update interval (seconds) — how often to refresh.

Changes apply immediately as you type.

Quick strftime cheatsheet

%A weekday • %a short weekday • %d day • %m month • %Y year • %H hour (00–23) • %M minute • %S second

Examples:

  • %A %d/%m/%Y %H:%MSunday 24/08/2025 22:04
  • %Y-%m-%d %H:%M:%S2025-08-24 22:04:09
  • %d.%m.%Y %H:%M24.08.2025 22:04

Troubleshooting

Clock missing or doubled?

  • List clock-like extensions and disable the extra one:

    gnome-extensions list | grep -Ei 'clock|date|time'
    gnome-extensions disable <conflicting-extension-uuid>
  • If the panel label doesn’t refresh:

    • Make sure your Update interval is > 0.
    • On Xorg you can press Alt+F2, type r, Enter (restart shell). On Wayland, log out and back in.

Reset preferences (45+ schema):

gsettings reset-recursively org.gnome.shell.extensions.numeric-clock

Check what’s installed / enabled:

gnome-extensions info numeric-clock@nickotmazgin
gnome-extensions list --enabled

Logs:

journalctl --user -b 0 -o cat | grep -i numeric-clock

Packaging & releases (for maintainers)

E.G.O. reads the integer "version" in metadata.json:

  • 45+ build"version": 7
  • 42–44 build"version": 12

Common metadata fields:

{
  "uuid": "numeric-clock@nickotmazgin",
  "name": "Numeric Clock",
  "description": "Top-bar clock with a numeric format (DD/MM/YYYY 24-hour).",
  "settings-schema": "org.gnome.shell.extensions.numeric-clock",
  "url": "https://github.com/nickotmazgin/Linux-Numeric-Date-And-Clock"
}

45+ build (from main):

cd numeric-clock@nickotmazgin
rm -f schemas/gschemas.compiled                  # must NOT ship on 45+
# ensure metadata has "icon": "icon.png"
gnome-extensions pack . --force --out-dir ..
# -> ../numeric-clock@nickotmazgin.shell-extension.zip

Legacy 42–44 build (from legacy/42-44):

cd numeric-clock@nickotmazgin
glib-compile-schemas schemas                     # produce schemas/gschemas.compiled
gnome-extensions pack . --force --out-dir ..
# -> ../numeric-clock@nickotmazgin.shell-extension.zip

Release flow

  1. Upload the appropriate ZIP(s) to GitHub Releases.
  2. On E.G.O., submit the 45+ update (v7) and keep legacy v12 available via the dropdowns.

Do not commit schemas/gschemas.compiled to the repo; it’s a build artifact (only inside the legacy ZIP).


Privacy

No network access. Only local preferences are stored.


License

MIT © Nick Otmazgin — see LICENSE.


Support

If you enjoy the extension and want to support development: PayPal: https://www.paypal.com/paypalme/nickotmazgin


Contact

nickotmazgin.dev@gmail.com


About

A GNOME Shell extension that replaces the top-bar clock with a customizable numeric date and time format strings etc (DD/MM/YYYY HH:MM). Works on Wayland & Xorg, and users can modify the date/time formats strings etcetera and update intervals through the extension interface window or gsettings. Configurable to show the time in a 24-hour format.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published