org.nvim

Timers and notifications

:Org timer_startStart a relative timer. A count asks for an offset H:MM:SS (default: the timer value on the line; a bare number is seconds, M:SS minutes). A negative offset (-0:05:00) starts the timer that long before zero: like Emacs, its value is shown without the sign, counting down to 0:00:00 and then up. 16 shifts the timer values of the selection instead.
:Org timer_insertInsert the timer value after the cursor, written with timer.format ("%s "). Starts the timer if needed; a count restarts it; 16 shifts the timer values of the selection. During a countdown, the remaining time.
:Org timer_itemInsert a - 0:01:23 :: item: below the current item in a timer list, turning the current line into one elsewhere (an error in other lists).
:Org timer_pausePause or continue the timer or countdown.
:Org timer_stopStop the timer or countdown.
:Org timer_countdown NCountdown of N minutes (or H:MM:SS, M:SS). Without an argument: a count (minutes), else the entry's Effort, else a prompt suggesting timer.default_timer. At the end you get a notification (clock.sound, clock.notification_handler).
:Org timer_remainingShow the remaining countdown time.

One timer runs at a time; require("org").statusline() shows it. User autocmds: OrgTimerStart, OrgTimerStop, OrgTimerPause, OrgTimerContinue, OrgTimerSet, OrgTimerDone. Note: Emacs distinguishes C-u from a numeric prefix for the countdown (C-u = the default timer); Neovim has only counts, so a count is always a number of minutes.

Appointment reminders (notifications.enabled = true, or :Org notifications_start): timed SCHEDULED, DEADLINE and plain timestamps from the agenda files trigger vim.notify() at each of reminder_time minutes before the start. With system_notification, a desktop notification is sent too: osascript on macOS, notify-send on Linux and the BSDs, and a toast through powershell.exe (Windows PowerShell, part of Windows) on Windows and in WSL without notify-send. The toasts show "Windows PowerShell" as their sender. :checkhealth org says which one is used. Set notifications.notifier = function(n) ... end to deliver them yourself.

Each reminder is sent once per entry, which is known by its file, headline and start time: editing the file doesn't repeat it, and a headline whose SCHEDULED or DEADLINE time is also a plain timestamp gets one reminder. With several Neovim instances running, single_instance (on by default) lets only one of them send reminders. It holds a lock file in stdpath("data")/org, and another instance takes over, without repeating what was sent, when that one exits or stops checking for three check_intervals. Set single_instance = false to have every instance remind you.