timer.nvim

Minimal Neovim plugin that lets you start short timers from anywhere inside the editor, pick predefined durations from a centered floating window, and check how much time remains without leaving your buffer.

• Floating picker that appears in the middle of the screen with configurable durations (5, 10, 30, 45, 60 minutes by default).
• Remaining-time popup (TimerRemaining) with mm:ss readout and a reset shortcut.
• Notifications when the timer starts or finishes.
• Fully written in Lua, no external dependencies beyond a recent Neovim (0.8+) with vim.ui and floating-window support.

{
  "temelgunaydin/timer.nvim",
  config = function()
    require("timer").setup({
      options = { 5, 10, 30, 45, 60 }, -- customize durations
      open_keymap = "<leader>tt",      -- open picker
      remaining_keymap = "<leader>tr", -- show remaining time popup
    })
  end,
}

use({
  "temelgunaydin/timer.nvim",
  config = function()
    require("timer").setup()
  end,
})

• :TimerPick or the open_keymap (default <leader>tt) opens the centered picker. Press 1, 2, 3, … or use <CR> to start a timer.
• :TimerRemaining or remaining_keymap (default <leader>tr) shows the remaining time popup; press r to reset the timer, or close the popup with q, <Esc>, or <CR>.
• Notifications announce when a timer starts and finishes.

Set a keymap option to false to skip creating that mapping. Leave options unset or nil to use the defaults or legacy keymap alias. An explicit open_keymap takes precedence over keymap, including when set to false. The commands remain available when keymaps are disabled.

• :TimerPick – open the duration picker.
• :TimerRemaining – show remaining time for the active timer.

Bug reports and PRs are welcome.

Run the keymap regression checks in Neovim without loading your personal configuration:

nvim --headless -u NONE -i NONE -c "lua dofile('tests/keymaps.lua')" -c 'qa!'

MIT © Temel Gunaydin