Skip to content

Latest commit

 

History

History
41 lines (25 loc) · 2.29 KB

README.md

File metadata and controls

41 lines (25 loc) · 2.29 KB

gnome-shell-clock-override

Override the Gnome Shell clock with a new time format or text of your choice. Works with new versions of Shell such as 3.18.

Get GNOME Extension

Gnome Shell doesn't permit many changes to the format of its clock; in particular, it's not possible to remove it completely or to add text around it. That's what this extension is for: you can set the clock's "format string" to change how the Gnome Shell clock is displayed (do you want it as HH:MM? HH.MM? "10:37:21 am"?), including setting it to just a fixed string (for example, a bell) so you have somewhere to click to see notifications and calendar but no clock on-screen.

Extension screenshot

For techies, we use the GLib GDateTime codes to specify actual times in your clock string, with three additions:

  • %;cf, a little emoji Unicode clock face (thanks to dsboger for that!)
  • %;vf, quarters as vulgar fractions
  • %;@, internet time (.beat)
  • %n, line breaks

Note that we still try to honour Gnome Shell's clock settings. So if you expect your clock to show seconds (or to update once a second, rather than once a minute) then you'll need to have turned on "show seconds" in Gnome Tweak Tool (under Top Bar) (or the terminal way).

Building from GitHub

The make definition file knows all you need to build, distribute, and install (for the current user) the extension.

make -j [build|clean|dist|distclean|install|test]

Dependencies:

  • gettext
  • GNU Make
  • glib-compile-schemas
  • gnome-shell 3.18 or newer
  • gnome-shell-extension-tool
  • ZIP

Development Dependencies:

  • jasmine-gjs

Translations wanted

Please help us translate Clock Override to more languages. You can find translations in the locale directory. You can help by adding any missing strings (lines with msgstr "") in your language, or by adding a new language.