The Minimalist Pomodoro Timer for Obsidian.
Boost your productivity and maintain focus without ever leaving your notes. PomoBar is a sleek, unobtrusive Pomodoro timer that lives in your Obsidian status bar, with optional audio notifications to keep you on track. Seamlessly integrate the Pomodoro Technique into your workflow with visual and audible cues.
| Default View | Running View |
|---|---|
 |
 |
| Also available with icons! | ...and they change when running! |
 |
 |
- 🧘 Stay Focused, Not Distracted: PomoBar lives in your status bar, providing a constant but subtle reminder of your work session without cluttering your workspace.
- 🔊 Optional Audio Notifications: Get gentle sound alerts when timers complete—choose from default sounds or use your own custom audio files.
- 🖱️ Intuitive & Quick Controls: Manage your timers with simple clicks—no need to open new windows or type commands.
- 🔄 Automated Flow: Automatically cycles between work and break periods, so you can keep your momentum going.
- ⚙️ Fully Customizable: Adjust timer durations, enable/disable sounds, and personalize your Pomodoro experience to fit your workflow perfectly.
The timer appears in your status bar. Here’s how to use it:
- Left-click: Start or pause the timer.
- Middle-click: Instantly cycle between work, short break, and long break timers.
- Right-click: Reset the current timer (when paused).
For more detailed instructions, check out our documentation.
For our keyboard-centric users, PomoBar includes a comprehensive set of commands that allow you to control the timer without touching your mouse. You can assign custom hotkeys to these commands in Obsidian's settings for a truly personalized and efficient workflow.
- Start/Pause timer: Toggle the timer on or off.
- Reset current timer: Reset the timer for the current session.
- Cycle to next timer duration: Switch between work, short break, and long break.
- Toggle sound notifications: Enable or disable audio alerts on the fly.
- Toggle status bar visibility: Show or hide the timer display.
- Toggle icon visibility: Control status bar icon display.
- Open Settings → Community Plugins in Obsidian.
- Disable Safe Mode if it's enabled.
- Click Browse and search for "PomoBar".
- Click Install, and then Enable the plugin.
- Download the latest release files (
main.js,manifest.json,styles.css) from the releases page. - Create a new folder named
pomobarinside your vault's.obsidian/plugins/directory. - Copy the downloaded files into this new folder.
- Reload Obsidian (Ctrl/Cmd + R) and enable the plugin in the settings.
PomoBar is a free and open-source project built for the Obsidian community. We believe in the power of collaboration and welcome contributions of all kinds. Whether you're a developer, a designer, or just an enthusiastic user, you can help shape the future of this plugin.
- Source Code: The complete source code is available on GitHub.
- Contribute: Have an idea or a bug fix? See our contribution guidelines to get started.
- License: The project is licensed under the MIT License.