A minimalist Pomodoro timer that lives in your Obsidian status bar. Focus on your work while keeping track of time with this unobtrusive timer.
Description | Screenshots |
---|---|
Default View | ![]() |
Running | ![]() |
While learning to make Obsidian plugins, I thought it would be a good idea to make a Pomodoro timer that lives in the status bar. I use one all the time!
- Clean and simple status bar timer
- Default 25-minute Pomodoro sessions with 15 and 5-minute break options
- Easy controls:
- Left click to start/stop the timer
- Middle click to cycle between 25/15/5 minute durations
- Right click to reset
- Minimal interface that doesn't get in your way
- Open Obsidian Settings
- Navigate to Community Plugins and disable Safe Mode
- Click Browse and search for "PomoBar"
- Install the plugin
- Enable the plugin in your Community Plugins list
- Look for the timer in your status bar (shows as "25:00" when not started)
- Left click to start the timer
- Left click again to pause the timer
- Middle click to cycle between different durations (25/15/5 minutes)
- When paused, right click to reset to the current duration
- Timer will automatically stop when it reaches 00:00
- Create a new folder
pomobar
in your vault's.obsidian/plugins
folder - Copy
main.js
,manifest.json
, andstyles.css
to the new folder - Reload Obsidian to load the plugin
- Update your
manifest.json
with your new version number, such as1.0.1
, and the minimum Obsidian version required for your latest release. - Update your
versions.json
file with"new-plugin-version": "minimum-obsidian-version"
so older versions of Obsidian can download an older version of your plugin that's compatible. - Create new GitHub release using your new version number as the "Tag version". Use the exact version number, don't include a prefix
v
. See here for an example: https://github.com/obsidianmd/obsidian-sample-plugin/releases - Upload the files
manifest.json
,main.js
,styles.css
as binary attachments. Note: The manifest.json file must be in two places, first the root path of your repository and also in the release. - Publish the release.
You can simplify the version bump process by running
npm version patch
,npm version minor
ornpm version major
after updatingminAppVersion
manually inmanifest.json
. The command will bump version inmanifest.json
andpackage.json
, and add the entry for the new version toversions.json
The code in this repository is available under the MIT License.