Skip to content

Pomodoro time tracker for NeoVim written entirely in LUA

License

Notifications You must be signed in to change notification settings

dbinagi/nomodoro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 

Repository files navigation

logo

Finally, Nvim + Pomodoro!

Yes, its another Pomodoro plugin for Nvim. Originally made to my own use and to learn the basics of plugin creation with Neovim.

I decided to leave this available for everyone that can find it useful also and please feel free to use, copy, comment or change anything you want.

demo

Features

  • Setup your pomodoro sessions time
  • Start and Stop sessions
  • Show status realtime from other plugins
  • Not just Pomodoro focused! Custom timer for any use

Quickstart

Instalation

Using vim-plug

Plug 'dbinagi/nomodoro'

Setup

To load plugin with default configuration:

require('nomodoro').setup({})

Setup

Default Configuration

require('nomodoro').setup({
    work_time = 25,
    short_break_time = 5,
    long_break_time = 15,
    break_cycle = 4,
    menu_available = true,
    texts = {
        on_break_complete = "TIME IS UP!",
        on_work_complete = "TIME IS UP!",
        status_icon = "🍅 ",
        timer_format = '!%0M:%0S' -- To include hours: '!%0H:%0M:%0S'
    },
    on_work_complete = function() end,
    on_break_complete = function() end
})

Commands

Command Description
NomoWork Start work timer
NomoBreak Start break timer
NomoStop Stop all timers
NomoStatus Print time left manually
NomoTimer N Runs a timer for N minutes
NomoPause Pauses current timer
NomoContinue Resumes current timer

Configure keys

By default, no shortcuts are provided, you could configure the following.

local map = vim.api.nvim_set_keymap
local opts = { noremap = true, silent = true }

map('n', '<leader>nw', '<cmd>NomoWork<cr>', opts)
map('n', '<leader>nb', '<cmd>NomoBreak<cr>', opts)
map('n', '<leader>ns', '<cmd>NomoStop<cr>', opts)

Optional UI

Integration with lualine

As an example, to integrate the status realtime with lualine use the following:

local lualine = require'lualine'
lualine.setup({
    sections = {
        lualine_x = {
            require('nomodoro').status,
        }
    }
})

Integration with nui.menu

If you like menus, you can install the dependency nui.menu and you will have enable a command NomoMenu to display options in a popup

menu

Contributions

Contributions are more than welcome! Thanks to:

@gaardhus @nfwyst

About

Pomodoro time tracker for NeoVim written entirely in LUA

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages