Omahub
← All plugins
C

Countdown

by Cristiano Corsi

Countdowns in the bar, with visible progress and a panel to manage them.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
17b7e52
Scanned
1 month 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

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
17b7e52
Reviewed
1 month ago

The plugin is a straightforward countdown bar widget with no network access, no destructive commands, and no hidden behavior. Its state handling is carefully bounded and defensive, and the sampled code matches the documented functionality.

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/CristianoCorsi/omarchy-countdown --enable
Widgets #bar #quickshell
<h1 align="center">Countdown</h1> <p align="center"> Countdowns for the <a href="https://omarchy.org">Omarchy</a> bar. The widget shows the time remaining until a deadline, can draw progress below the label, and opens a panel for managing multiple countdowns. </p> <p align="center"> <a href="https://plugins.omarchy.org/plugin.html?id=cristianocorsi.countdown"><img alt="On omarchyplugins.com" src="https://img.shields.io/badge/omarchyplugins.com-listed-8b5cf6"></a> </p> <p align="center"> <img src="preview.png" alt="Countdown bar widget and management panel" width="430"> </p>

Screenshots

Bar widget

<p align="center"> <img src="screenshots/bar.png" alt="Countdown in the Omarchy bar" width="200"> </p>

Management panel

<p align="center"> <img src="screenshots/configuration.png" alt="Countdown management panel with example entries" width="399"> </p>

Installation

omarchy plugin add https://github.com/CristianoCorsi/omarchy-countdown.git --enable

Usage

Gesture Effect
Click Open the management panel
Right click Select the next countdown
Scroll Cycle through countdowns

From the panel you can add, edit, reorder, and delete entries. Clicking an entry selects the countdown shown in the bar.

IPC

omarchy-shell cristianocorsi.countdown toggle
omarchy-shell cristianocorsi.countdown next
omarchy-shell cristianocorsi.countdown previous

Settings

Configure these values from Omarchy's bar settings or directly on the widget entry in ~/.config/omarchy/shell.json.

Key Default Description
format days days, percentage, or auto
maxLabel 16 Maximum label length before truncation
showProgress true Draw progress below the label
alertDays 3 Highlight the widget below this number of days

The auto format shows days while more than one day remains, then switches to hours and finally minutes.

State

Countdown data is stored locally in ~/.local/state/omarchy/countdown.json:

{
  "state": { "current_index": 0 },
  "countdowns": [
    {
      "label": "Release 1.0",
      "start": "2030-01-01",
      "end": "2030-03-31",
      "format": "days"
    }
  ]
}

start is used to calculate progress. The plugin accepts non-zero-padded dates for compatibility, but writes dates back in canonical YYYY-MM-DD form. The file is watched for changes so multiple monitors stay in sync. State is limited to 64 KiB, 64 countdowns, and 128 characters per label.

Update and removal

omarchy plugin update cristianocorsi.countdown --yes
omarchy plugin remove cristianocorsi.countdown

Development

Validate the plugin before publishing:

omarchy plugin validate .

Security and dependencies

This plugin runs unsandboxed inside omarchy-shell when enabled.

  • Network access: none.
  • External commands: /usr/bin/python3 runs the bundled state_io.py helper for bounded state reads and atomic writes.
  • Local data: reads and writes ~/.local/state/omarchy/countdown.json. The QML watcher never reads file content; the helper rejects symlinks, non-regular files, files owned by another user, unsafe writable modes, hard links, and payloads above 64 KiB before JSON decoding.
  • Elevated privileges and background services: none.
  • Dependencies: Omarchy Quattro, Quickshell, and the Python 3 runtime provided by Omarchy; no third-party Python packages are used.

License

MIT — see LICENSE.