Omahub
← All plugins
D

1440 - Day Countdown

by Dorneles

Constantly displays the minutes remaining until the end of the day on your status bar to boost productivity and mindful time management.

GitHub

Security review

Review recommended · 1 finding

Deterministic scan — not a security guarantee

Low
Risk level
Low
Analyzed commit
7caa928
Scanned
1 month ago

Flagged patterns appear only in documentation files (README / docs) — descriptive examples, not executable code.

  • Docs external_hosts README.md:59

    Downloads or connects to an external HTTP(S) host.

    git clone https://github.com/jvlianodorneles/omarchy-1440.git ~/.config/omarchy/plugins/dorneles.1440

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
7caa928
Reviewed
1 month ago

The plugin is a straightforward day-countdown bar widget with no obfuscation, credential access, or destructive operations. The deterministic scan flagged a git clone in the README, but that is documentation for manual installation and not part of the executable code. The bundled install.sh only copies files and edits the user's shell config, which is expected behavior for a plugin installer.

  • The install.sh script modifies ~/.config/omarchy/shell.json and removes any existing plugin directory before copying, which could overwrite user customizations for this plugin ID, but this is a standard installer pattern and not malicious.
  • The notify-status.sh script uses notify-send with a 'critical' urgency flag, which could be slightly intrusive but is user-configurable and not harmful.
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/jvlianodorneles/omarchy-1440 --enable
Productivity #quickshell

1440 for Omarchy ⌛

A mindfulness and productivity status bar plugin for Omarchy that continuously tracks and visualizes the minutes remaining until the end of the day.

Based on the 1440 Cinnamon Applet, redesigned and engineered from the ground up natively for Omarchy and Quickshell.

<p align="center"> <img src="preview.png" alt="1440 Plugin Preview" width="550"> </p>

💡 Concept

There are 1,440 minutes in every day ($24 \times 60 = 1440$). Unlike money, time cannot be saved or refunded — once a minute passes, it is gone forever. 1440 keeps this awareness front and center on your status bar, helping you manage deadlines, study sessions, and daily routines with focus and purpose.

✨ Features

  • ⏱️ Real-Time Day Countdown: Constantly tracks remaining minutes until midnight synchronized with the system clock.
  • 📍 Bar Section Placement: Switch placement directly between Left, Center, and Right sections of the status bar in one click.
  • 📊 Multiple Display Formats:
    • Minutes: 840 min / 840
    • Compact: 840m
    • Hours & Minutes: 14h 00m
    • Percentage: 58.3% (remaining)
    • Fraction: 840 / 1440
  • 🎨 3 Badge & Visual Styles:
    • Flat: Minimalist transparent bar integration.
    • Pill: Clean capsule badge contour.
    • Progress Pill: Dynamic subtle background fill showing day completion progress.
  • 🎯 Configurable Icons:
    • Hourglass (⌛), Nerd Font Hourglass (󰔛 / \uf252), Nerd Font Clock (󰥔 / \uf017), Flame (🔥), or Off.
  • 🚨 Urgent Warning Threshold: Highlights the widget in alert/urgent color when remaining minutes drop below a customizable threshold (e.g. $< 120\text{ min}$).
  • 🔔 Milestone Desktop Notifications: Optional notifications on key day checkpoints ($75%$, $50%$ midday, $25%$ evening, and final $2\text{h}$).
  • 🎛️ Rich Interactive Dashboard:
    • Large countdown display and remaining time summary.
    • Visual 24-hour progress track ($00:00 \to 23:59$).
    • Stoic & time-management daily quotes.
    • Live configuration controls with instant persistence.
  • 📐 Orientation Responsive: Seamlessly supports both horizontal and vertical bars.
  • 🎨 Omarchy Theme Integration: Fully honors system theme palettes, font families, and colors (Color.foreground, Color.accent, bar.urgent).

📦 Installation

Method 1: Using the Omarchy CLI (Recommended)

omarchy plugin add https://github.com/jvlianodorneles/omarchy-1440.git --enable --yes

Method 2: Manual Installation

  1. Clone the repository into your Omarchy plugins directory:

    git clone https://github.com/jvlianodorneles/omarchy-1440.git ~/.config/omarchy/plugins/dorneles.1440

  2. Rescan and enable the plugin:

    omarchy-shell shell rescanPlugins
omarchy plugin enable dorneles.1440

Or run the bundled ./install.sh script inside the repository.

🎮 Controls & Interactions

Action Trigger Description
Toggle Dashboard Left-Click Opens/closes the interactive daily dashboard popup
Quick Cycle Format Middle-Click Cycles through display formats (min ➔ compact ➔ h:m ➔ % ➔ fraction)
Settings / Menu Right-Click Opens settings and dashboard popup
Cycle Formats Mouse Wheel Cycles through available display formats

⚙️ Configuration (~/.config/omarchy/shell.json)

You can tune settings directly via the interactive popup card or in ~/.config/omarchy/shell.json:

{
  "id": "dorneles.1440",
  "format": "minutes",
  "iconStyle": "hourglass",
  "badgeStyle": "flat",
  "showIcon": true,
  "showSuffix": true,
  "urgentThreshold": 120,
  "showNotifications": true
}

Options Reference

Option Type Values Default Description
format enum "minutes", "compact", "hours_minutes", "percentage", "fraction" "minutes" Label format displayed on the status bar.
iconStyle enum "hourglass", "nerd", "clock", "flame", "none" "hourglass" Prefix icon glyph.
badgeStyle enum "flat", "pill", "progress" "flat" Widget capsule and background styling.
showIcon boolean true, false true Show or hide the prefix icon.
showSuffix boolean true, false true Show or hide unit suffix (min or m).
urgentThreshold integer 0 - 720 120 Threshold (in minutes) to trigger urgent warning styling ($0$ to disable).
showNotifications boolean true, false true Send desktop notifications on day milestones.

📡 IPC Commands

Control the plugin directly from terminal scripts or keybindings:

# Force refresh time calculations
omarchy-shell dorneles.1440 refresh

# Toggle dashboard popup
omarchy-shell dorneles.1440 toggle

# Cycle display format
omarchy-shell dorneles.1440 cycleFormat

# Move widget section (left | center | right)
omarchy-shell dorneles.1440 moveSection center

# Send status desktop notification
omarchy-shell dorneles.1440 notify

🗑️ Removal / Uninstallation

# Disable from status bar
omarchy plugin disable dorneles.1440

# Remove plugin completely
omarchy plugin remove dorneles.1440 --yes

📄 License

MIT License © 2025-2026 Juliano Dorneles.