A simple Pomodoro timer plugin for Obsidian that tracks completed Pomodoros in your daily notes. This plugin does as little as possible. Even the settings could be disabled but I hadf been wavering between the length of my pomodoros.
- Start and stop Pomodoro timers via commands (no UI needed, use start pomodor from the command prompt)
- Automatically tracks completed Pomodoros in your daily notes frontmatter
- Display timer status in the status bar
- Click on the status bar emoji to see remaining time and the stop and restart buttons
- Automatically switch between Pomodoros and breaks
- 15-minute breaks after every 3 completed Pomodoros
- Configurable Pomodoro and break durations
- Start a Pomodoro timer using the "Start Pomodoro" command
- Timer shows in the status bar (🍅 for Pomodoro, ☕ for break)
- Click on the status bar emoji to see remaining time and controls
- When a Pomodoro completes, the counter in your daily note will automatically increment
- After 3 Pomodoros, you'll automatically get a 15-minute break
- Pomodoro Length: Duration of each Pomodoro session (default: 25 minutes)
- Short Break Length: Duration of short breaks (default: 5 minutes)
- Long Break Length: Duration of long breaks after 3 Pomodoros (default: 15 minutes)
- Frontmatter Counter Name: The name of the counter in your daily note frontmatter (default: "pomodoros")
- Open Obsidian Settings
- Go to Community Plugins
- Search for "Pomodoro Timer"
- Click Install and Enable
- Download the latest release
- Extract the zip file into your Obsidian vault's
.obsidian/plugins/
directory - Enable the plugin in Obsidian settings
This plugin automatically adds and updates a "pomodoros" (configurable) count in your daily note's frontmatter. The format will be:
---
pomodoros: 5
---
- Clone this repo to your development folder
- Run
npm i
to install dependencies - Run
npm run dev
to start compilation in watch mode - Copy over
main.js
,manifest.json
to your vault's.obsidian/plugins/obsidian-pomodoro-timer/
directory
MIT