osfeed.dev
Projects/crmne / omacal

OmaCal

A HEY calendar and clock plugin for Omarchy

Get it on GitHub
Unclaimed

This page was written by @iluxav from public sources, last updated for v1.0.6 (2026-09-30), and may lag behind new releases.

Are you @crmne?Claim this page to keep it up to date
v1.0.6 · 12 things you can do 1 change to know before upgrading
Follow GitHub

View and manage your HEY calendar, receive reminders, and track time from Omarchy's bar.

What you can do with OmaCal

Browse your HEY events in a month grid and selected-day view.

Since v1.0.6
Good to know

HEY only; no day titles, photos or Sometime this week. hey-cli 1.3.x cannot show single-occurrence edits or deletions and includes disabled calendars; use `hiddenCalendars` or hey-cli 1.4+.

Create HEY events from the panel or a keyboard shortcut.

Since v1.0.6
Good to know

The default `Alt+Shift+Space` shortcut is not bound if already taken; only HEY is supplied as a backend.

Schedule an event using different cities for its start and end times.

Since v1.0.6
Good to know

HEY displays the end in the start's zone, even when entered in another zone; the stored instant is preserved.

Edit an event's title, day, times, zones, place, calendar and reminder in the panel.

Since v1.0.6
Good to know

Cannot remove all reminders, edit notes, guests or repeats, or move a whole series to another day; use HEY. Existing event times open in local time.

Change one occurrence of a repeating event or apply an edit to the series.

Since v1.0.6
Good to know

Editing one day needs hey-cli 1.6.0+; 1.3.0 offers every day only. Moving a whole series to another day is left to HEY.

Open a scheduled meeting from the calendar's day view.

Since v1.0.6
Good to know

The event must have a meeting link.

Delete a one-off HEY event from its hover button after confirmation.

Since v1.0.6
Good to know

Repeating-event deletion is left to HEY because deleting by ID would delete the series.

Receive HEY reminders as desktop notifications that open the meeting or event.

Since v1.0.6
Good to know

Requires reminders set in HEY and a desktop notification service.

Show all 12

Start, stop, rename and delete HEY time tracks while viewing daily totals.

Since v1.0.6
Good to know

HEY time tracking; starting and stopping are in today's view.

See calendar changes made elsewhere appear in the panel.

Since v1.0.6
Good to know

Uses `hey watch` for live sync with polling as fallback; hey-cli 1.3.x retains its recurrence limitations.

See an upcoming or ongoing event beside the clock in Omarchy's bar.

Since v1.0.6
Good to know

All-day events appear only with a reminder; events without reminders use `alertLeadMinutes`, 15 minutes by default.

Adjust calendar display, reminders and quick-add settings from the panel using the keyboard.

Since v1.0.6
Good to know

Settings are saved to the widget entry in `~/.config/omarchy/shell.json`.

Before you upgrade OmaCal

Newest first
v1.0.6

Move incorrectly timed events to their intended times in HEY; upgrading to v1.0.3 or later fixes new events but does not repair existing ones.

Action requiredAffects: Users whose events created before v1.0.3 were saved at the wrong time.
Read the evidence
OmaCal release history 1
v1.0.6
First release
with v1.0.0, v1.0.1, v1.0.2, v1.0.3, v1.0.4, v1.0.5

Manage your HEY calendar from Omarchy's clock panel.

Details

The v1.0.0–v1.0.6 launch series adds calendar browsing and creation, then time-zone controls and in-panel editing. Event clicks now edit; `J` joins, and `Alt+Z` reveals zones or resets them to local time when hidden.

Also: Quick add, time zones, reminders, time tracking, live sync and bar event labels; fixes for form reset, saved times, duplicate reminders and multi-day display.

v1.0.6; install with `omarchy plugin add https://github.com/crmne/omacal.git --enable`, then disable `omarchy.clock`. Requires Omarchy 4 Quattro, signed-in hey-cli 1.3.0+ and jq; single-occurrence editing needs hey-cli 1.6.0+.

Added: Browse your HEY events in a month grid and selected…Added: Create HEY events from the panel or a keyboard shor…Added: Schedule an event using different cities for its st…Added: Edit an event's title, day, times, zones, place, ca…Added: Change one occurrence of a repeating event or apply…Added: Open a scheduled meeting from the calendar's day vi…Added: Delete a one-off HEY event from its hover button af…Added: Receive HEY reminders as desktop notifications that…Added: Start, stop, rename and delete HEY time tracks whil…Added: See calendar changes made elsewhere appear in the p…Added: See an upcoming or ongoing event beside the clock i…Added: Adjust calendar display, reminders and quick-add se…Action required: Create HEY events from the panel or a keyboard shor…

Seeded by @iluxav with Codex

Read the evidence