{"id":13581055,"url":"https://github.com/olimorris/tmux-pomodoro-plus","last_synced_at":"2025-05-16T02:10:19.287Z","repository":{"id":43462631,"uuid":"355182566","full_name":"olimorris/tmux-pomodoro-plus","owner":"olimorris","description":"🍅 Incorporate the Pomodoro technique into your tmux workflow","archived":false,"fork":false,"pushed_at":"2025-03-12T15:18:37.000Z","size":669,"stargazers_count":374,"open_issues_count":4,"forks_count":33,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-12T01:11:11.684Z","etag":null,"topics":["pomodoro","tmux","tmux-plugin","tmux-plugins"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/olimorris.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-06T12:36:02.000Z","updated_at":"2025-05-10T00:05:19.000Z","dependencies_parsed_at":"2023-09-29T10:28:21.052Z","dependency_job_id":"d8ddf19b-79ee-480c-9cf6-635313564013","html_url":"https://github.com/olimorris/tmux-pomodoro-plus","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olimorris%2Ftmux-pomodoro-plus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olimorris%2Ftmux-pomodoro-plus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olimorris%2Ftmux-pomodoro-plus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olimorris%2Ftmux-pomodoro-plus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/olimorris","download_url":"https://codeload.github.com/olimorris/tmux-pomodoro-plus/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254453667,"owners_count":22073618,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["pomodoro","tmux","tmux-plugin","tmux-plugins"],"created_at":"2024-08-01T15:01:57.642Z","updated_at":"2025-05-16T02:10:19.269Z","avatar_url":"https://github.com/olimorris.png","language":"Shell","funding_links":[],"categories":["Shell","\u003ca name=\"time-tracker\"\u003e\u003c/a\u003eTime trackers","Status Bar"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/olimorris/tmux-pomodoro-plus/assets/9512444/a3e445f0-6493-4375-977e-b89013968604\" alt=\"Tmux Pomodoro Plus\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eTmux Pomodoro Plus\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/olimorris/tmux-pomodoro-plus/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/olimorris/tmux-pomodoro-plus?color=c678dd\u0026logoColor=e06c75\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/olimorris/tmux-pomodoro-plus/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/olimorris/tmux-pomodoro-plus?color=%23d19a66\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/olimorris/tmux-pomodoro-plus/blob/main/LICENSE.md\"\u003e\u003cimg src=\"https://img.shields.io/github/license/olimorris/tmux-pomodoro-plus?style=for-the-badge\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/olimorris/tmux-pomodoro-plus/actions/workflows/test.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/olimorris/tmux-pomodoro-plus/test.yml?branch=main\u0026label=tests\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\nIncorporate the \u003ca href=\"https://en.wikipedia.org/wiki/Pomodoro_Technique\"\u003ePomodoro technique\u003c/a\u003e into your \u003ca href=\"https://github.com/tmux/tmux\"\u003etmux\u003c/a\u003e setup. Forked from \u003ca href=\"https://github.com/alexanderjeurissen/tmux-pomodoro\"\u003eTmux Pomodoro\u003c/a\u003e\u003cbr\u003e\u003cbr\u003ePlease subscribe to \u003ca href=\"https://github.com/olimorris/tmux-pomodoro-plus/issues/29\"\u003ethis issue\u003c/a\u003e to be notified of any breaking changes to the plugin\n\u003c/p\u003e\n\n## :sparkles: Features\n\n- Toggle a Pomodoro and see the countdown and the break in the status bar\n- Skip, pause and resume a Pomodoro/break at any point\n- Customise the Pomodoro duration, break times and intervals\n- Restart your Pomodoros to automatically or be prompted\n- Desktop alerts for Pomodoros and breaks (MacOS and Linux only)\n- Custom keybindings\n\n## :camera: Screenshots\n\nPomodoro counting down:\n![Image](https://user-images.githubusercontent.com/9512444/218257051-1cdc4487-7e0a-4d1f-9e70-932028f47d6f.png)\n\nPomodoro on a break:\n![Image](https://user-images.githubusercontent.com/9512444/218257106-c3f83c7e-a467-4965-adfd-8c0b9b06ad9b.png)\n\nPomodoro counting down in real-time:\n![Image](https://user-images.githubusercontent.com/9512444/218257132-6aac32d9-6ecb-4192-926c-1c41cb4adc62.gif)\n\nPomodoro timer menu:\n![Image](https://user-images.githubusercontent.com/9512444/179624439-c5203dd1-01a9-4bf8-93dc-3da162939a4a.gif)\n\n## :package: Installation\n\n1. Using [TPM](https://github.com/tmux-plugins/tpm), add the following line to your `~/.tmux.conf` file:\n\n```bash\nset -g @plugin 'olimorris/tmux-pomodoro-plus'\n```\n\n\u003e **Note**: The above line should be _before_ `run '~/.tmux/plugins/tpm/tpm'`\n\n2. Then press `tmux-prefix` + \u003ckbd\u003eI\u003c/kbd\u003e (capital i, as in **I**nstall) to fetch the plugin as per the TPM installation instructions\n\n## :rocket: Usage\n\n### Default keybindings\n\n- `\u003ctmux-prefix\u003e p` to toggle between starting/pausing a Pomodoro/break\n- `\u003ctmux-prefix\u003e P` to cancel a Pomodoro/break\n- `\u003ctmux-prefix\u003e _` to skip a Pomodoro/break\n- `\u003ctmux-prefix\u003e e` to restart a Pomodoro\n- `\u003ctmux-prefix\u003e C-p` to open the Pomodoro timer menu\n- `\u003ctmux-prefix\u003e M-p` to set a custom Pomodoro timer\n\nThe Pomodoro timer menu and custom Pomodoro input are always `\u003cctrl\u003e/\u003calt\u003e + [your start Pomodoro key]`.\n\n### Status bar\n\nTo incorporate into your status bar:\n\n```bash\nset -g status-right \"#{pomodoro_status}\"\n```\n\n## :wrench: Configuration\n\n\u003e **Note**: On Linux, notifications depend on `notify-send/libnotify-bin`\n\nThe default configuration:\n\n```bash\nset -g @pomodoro_toggle 'p'                    # Start/pause a Pomodoro/break\nset -g @pomodoro_cancel 'P'                    # Cancel the current session\nset -g @pomodoro_skip '_'                      # Skip a Pomodoro/break\n\nset -g @pomodoro_mins 25                       # The duration of the Pomodoro\nset -g @pomodoro_break_mins 5                  # The duration of the break after the Pomodoro completes\nset -g @pomodoro_intervals 4                   # The number of intervals before a longer break is started\nset -g @pomodoro_long_break_mins 25            # The duration of the long break\nset -g @pomodoro_repeat 'off'                  # Automatically repeat the Pomodoros?\nset -g @pomodoro_disable_breaks 'off'          # Turn off breaks\n\nset -g @pomodoro_on \" 🍅\"                      # The formatted output when the Pomodoro is running\nset -g @pomodoro_complete \" ✔︎\"                 # The formatted output when the break is running\nset -g @pomodoro_pause \" ⏸︎\"                    # The formatted output when the Pomodoro/break is paused\nset -g @pomodoro_prompt_break \" ⏲︎ break?\"      # The formatted output when waiting to start a break\nset -g @pomodoro_prompt_pomodoro \" ⏱︎ start?\"   # The formatted output when waiting to start a Pomodoro\n\nset -g @pomodoro_menu_position \"R\"             # The location of the menu relative to the screen\nset -g @pomodoro_sound 'off'                   # Sound for desktop notifications (Run `ls /System/Library/Sounds` for a list of sounds to use on Mac)\n                                               # (On Linux add `on` to use the `beep` program or add your custom beeping command)\n\nset -g @pomodoro_notifications 'off'           # Enable desktop notifications from your terminal\nset -g @pomodoro_granularity 'off'             # Enables MM:SS (ex: 00:10) format instead of the default (ex: 1m)\n```\n\n### Customising the status line\n\nThe output from the plugin can be customised to fit in with your statusline:\n\n```bash\nset -g @pomodoro_on \"#[fg=$text_red]🍅 \"\nset -g @pomodoro_complete \"#[fg=$text_green]🍅 \"\nset -g @pomodoro_pause \"#[fg=$color_yellow]🍅 \"\nset -g @pomodoro_prompt_break \"#[fg=$color_green]🕤 ? \"\nset -g @pomodoro_prompt_pomodoro \"#[fg=$color_gray]🕤 ? \"\n```\n\nThe current and total number of intervals can also be displayed:\n\n```bash\nset -g @pomodoro_interval_display \"[%s/%s]\"\n```\n\n\u003e **Note**: If you provide just 1 `%s` then the current interval count will be displayed only\n\nA real-time countdown can be also be displayed:\n\n```bash\nset -g @pomodoro_granularity 'on'\nset -g status-interval 1                       # Refresh the status line every second\n```\n\n## :clap: Credits\n\n- [Wladyslaw Fedorov](https://dribbble.com/Wladza) - For the squashed tomato image\n\n## :page_with_curl: License\n\n[MIT](https://github.com/olimorris/tmux-pomodoro-plus/blob/master/LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Folimorris%2Ftmux-pomodoro-plus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Folimorris%2Ftmux-pomodoro-plus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Folimorris%2Ftmux-pomodoro-plus/lists"}