{"id":25853675,"url":"https://github.com/semanticdata/obsidian-pomodoro","last_synced_at":"2026-04-28T19:02:14.662Z","repository":{"id":273976855,"uuid":"921501728","full_name":"semanticdata/obsidian-pomodoro","owner":"semanticdata","description":"PomoBar is a minimalist Pomodoro timer that lives in your Obsidian status bar with optional audio notifications to keep you on track","archived":false,"fork":false,"pushed_at":"2025-12-29T18:34:34.000Z","size":692,"stargazers_count":10,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-30T14:37:41.034Z","etag":null,"topics":["obsidian","obsidian-plugin","pomodoro","productivity"],"latest_commit_sha":null,"homepage":"https://semanticdata.github.io/obsidian-pomodoro/","language":"TypeScript","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/semanticdata.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-24T04:13:14.000Z","updated_at":"2025-12-29T19:03:16.000Z","dependencies_parsed_at":"2025-01-24T05:24:56.014Z","dependency_job_id":"4803cb73-604a-49b1-9114-4baab0deaefc","html_url":"https://github.com/semanticdata/obsidian-pomodoro","commit_stats":null,"previous_names":["semanticdata/obsidian-pomodoro"],"tags_count":8,"template":false,"template_full_name":"obsidianmd/obsidian-sample-plugin","purl":"pkg:github/semanticdata/obsidian-pomodoro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semanticdata%2Fobsidian-pomodoro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semanticdata%2Fobsidian-pomodoro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semanticdata%2Fobsidian-pomodoro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semanticdata%2Fobsidian-pomodoro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/semanticdata","download_url":"https://codeload.github.com/semanticdata/obsidian-pomodoro/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semanticdata%2Fobsidian-pomodoro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32394478,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T14:34:11.604Z","status":"ssl_error","status_checked_at":"2026-04-28T14:32:37.009Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["obsidian","obsidian-plugin","pomodoro","productivity"],"created_at":"2025-03-01T15:19:00.429Z","updated_at":"2026-04-28T19:02:14.657Z","avatar_url":"https://github.com/semanticdata.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🍅 PomoBar\n\n**The Minimalist Pomodoro Timer That Keeps You Focused in Obsidian**\n\nBoost your productivity without ever leaving your notes. PomoBar is a sleek, unobtrusive Pomodoro timer that lives in your status bar—with optional audio notifications to keep you on track. Seamlessly integrate the Pomodoro Technique into your workflow with visual and audible cues.\n\n## ✨ Why PomoBar?\n\n### 🧘 Stay Focused, Not Distracted\n\nPomoBar lives in your status bar, providing a constant but subtle reminder of your work session without cluttering your workspace or interrupting your flow.\n\n### 🔊 Optional Audio Notifications\n\nGet gentle sound alerts when timers complete. Choose from built-in sounds or upload your own custom audio files from your vault.\n\n### 🖱️ Intuitive \u0026 Quick Controls\n\nManage your timers with simple clicks—no need to open new windows or type commands.\n\n### 🔄 Automated Flow\n\nOptional auto-progression automatically starts the next timer in your Pomodoro cycle, or pause after each session for manual control.\n\n### ⚙️ Your Rhythm, Your Rules\n\nDeep work sessions aren't one-size-fits-all. Custom-tune your work/break intervals to match your energy levels.\n\n---\n\n## 📸 See It In Action\n\n|                          Default View                          |                          Running View                          |\n| :------------------------------------------------------------: | :------------------------------------------------------------: |\n|      ![screenshot-1](./docs/screenshots/screenshot-1.png)      |      ![screenshot-2](./docs/screenshots/screenshot-2.png)      |\n|                  _Also available with icons!_                  |               _...and they change when running!_               |\n| ![screenshot-icon-1](./docs/screenshots/screenshot-icon-1.png) | ![screenshot-icon-2](./docs/screenshots/screenshot-icon-2.png) |\n\n---\n\n## 🎮 How It Works\n\nThe timer appears in your status bar. Control everything with simple mouse clicks:\n\n- **Left-click** - Start or pause the timer\n- **Middle-click** - Instantly cycle between work, short break, and long break timers\n- **Right-click** - Reset the current timer (when paused)\n\n### ⌨️ Keyboard-Friendly Commands\n\nPrefer keyboard shortcuts? PomoBar includes comprehensive commands you can assign to custom hotkeys in Obsidian's settings:\n\n| Command                      | Description                                      |\n| ---------------------------- | ------------------------------------------------ |\n| Start/Pause timer            | Toggle the timer on or off                       |\n| Reset current timer          | Reset the timer for the current session          |\n| Cycle to next timer duration | Switch between work, short break, and long break |\n| Toggle sound notifications   | Enable or disable audio alerts on the fly        |\n| Toggle status bar visibility | Show or hide the timer display                   |\n| Toggle icon visibility       | Control the status bar icon display              |\n\nFor more detailed instructions, check out our [full documentation](https://semanticdata.github.io/obsidian-pomodoro/).\n\n## ⚙️ Configurable to Your Needs\n\nPomoBar adapts to your unique work style:\n\n- Flexible Durations - Customize work, short break, and long break durations\n- Cycle Control - Set how many work sessions before a long break\n- Audio Options - Choose from 6 built-in sounds or use your own files\n- Volume Control - Adjust sound volume to your preference\n- Visual Preferences - Show/hide icons and the entire status bar timer\n- Auto-Progress - Automatically start the next session or pause for manual control\n\n## 🚀 Installation\n\n### From Obsidian Community Plugins (Recommended)\n\n1. Open **Settings** → **Community Plugins** in Obsidian\n2. Disable **Safe Mode** if it's enabled\n3. Click **Browse** and search for \"PomoBar\"\n4. Click **Install**, then **Enable** the plugin\n\n### Manual Installation\n\n1. Download the latest release files (`main.js`, `manifest.json`, `styles.css`) from the [releases page](https://github.com/semanticdata/obsidian-pomodoro/releases)\n2. Create a new folder named `pomobar` inside your vault's `.obsidian/plugins/` directory\n3. Copy the downloaded files into this new folder\n4. Reload Obsidian (Ctrl/Cmd + R) and enable the plugin in the settings\n\n## 💬 Community \u0026 Support\n\nPomoBar 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.\n\n- 📖 Documentation - [Full documentation](https://semanticdata.github.io/obsidian-pomodoro/)\n- 🐛 Bug Reports - [Report an issue](https://github.com/semanticdata/obsidian-pomodoro/issues)\n- 💡 Feature Requests - [Start a discussion](https://github.com/semanticdata/obsidian-pomodoro/discussions)\n- 🔧 Contributing - [Contribution guidelines](https://github.com/semanticdata/obsidian-pomodoro/blob/master/CONTRIBUTING.md)\n- 📜 License - [MIT License](https://github.com/semanticdata/obsidian-pomodoro/blob/master/LICENSE)\n\n---\n\n**Ready to boost your productivity?** Install PomoBar from the [Obsidian Community Plugins](https://obsidian.md/plugins?search=PomoBar) marketplace today!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsemanticdata%2Fobsidian-pomodoro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsemanticdata%2Fobsidian-pomodoro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsemanticdata%2Fobsidian-pomodoro/lists"}