Omahub
← All plugins
L

Omarchy World Clock

by LeoMoon Studios

An offline world clock and timezone converter for the Omarchy bar.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
d49d2c2
Scanned
3 weeks ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
d49d2c2
Reviewed
3 weeks ago

This is a benign offline world clock widget. It only reads system timezone data and runs fixed commands with no shell interpretation, network access, or destructive operations. The deterministic scan found no issues, and the code matches the README's security claims.

  • The plugin reads system files (/etc/localtime, /usr/share/zoneinfo/*) and runs /usr/bin/date with user-controlled timezone strings, but timezone IDs are validated against a whitelist, so injection risk is minimal.
  • Settings are stored in ~/.config/leomoon-studios.omarchy-world-clock/settings.json; the plugin writes to this path but only with its own data, no user-controlled content beyond JSON values.
How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/leomoon-studios/omarchy-world-clock --enable
Productivity #quickshell

Omarchy World Clock

An offline world clock and timezone converter for the Omarchy 4 bar.

The bar stays minimal with a single world glyph. Clicking it opens a native, theme-aware Omarchy panel where you can view clocks, convert a future meeting time, and manage locations.

Preview

Omarchy World Clock preview

Features

  • Live clocks for up to 20 configured IANA timezones
  • Today, Tomorrow, and Yesterday labels
  • 12-hour and 24-hour display
  • Optional timezone abbreviations and UTC offsets
  • Reorder, remove, and rename saved locations
  • Future date/time conversion using the system timezone database
  • Searchable timezone pickers covering every installed IANA timezone; searches match timezone IDs, countries (including Iran), and regional descriptions
  • Validation for nonexistent spring-forward wall times
  • Completely offline with no telemetry or additional package

Install

omarchy plugin add https://github.com/leomoon-studios/omarchy-world-clock --enable --yes

The manifest places the widget in the right bar section by default. Move it if desired:

omarchy bar move leomoon-studios.omarchy-world-clock --section right --after omarchy.tray

Remove

omarchy plugin remove leomoon-studios.omarchy-world-clock --yes

Saved locations and display preferences are retained. To remove them too:

rm -r -- "$HOME/.config/leomoon-studios.omarchy-world-clock"

Automation

Locations and display settings are owned by the plugin and saved at ~/.config/leomoon-studios.omarchy-world-clock/settings.json so bar layout changes cannot reset the saved locations. Use the plugin's Settings panel to add, remove, reorder, or rename locations.

The shell.json bar entry controls placement only; it is not used for plugin settings.

Security and privacy

The plugin performs no network access and stores no secrets. It runs only fixed command arrays using /usr/bin/env, /usr/bin/date, /usr/bin/readlink, /usr/bin/cat, and /usr/bin/mkdir. It does not invoke a shell interpreter, request root access, or accept a custom executable path. Timezone data comes from the system's /usr/share/zoneinfo/iso3166.tab, zone.tab, and tzdata.zi from installed tzdata.

Development

omarchy plugin validate .
qmllint -I /usr/share/omarchy/shell BarWidget.qml Panel.qml TimezoneService.qml

License

MIT