Skip to content

Introduction

Welcome to the documentation for PomoBar, a Pomodoro timer plugin for Obsidian.

This plugin is designed to help you focus and be more productive by integrating a Pomodoro timer directly into your Obsidian workspace.

Default View Running View
screenshot-1 screenshot-2
Also available with icons! ...and they change when running!
screenshot-icon-1 screenshot-icon-2

Getting Started

  1. Install the plugin from Obsidian's Community Plugins
  2. Learn the controls - three simple mouse clicks control everything
  3. Customize settings to match your preferred work rhythm
  4. Start being more productive with focused work sessions!

Why Choose PomoBar?

🚀 Lightweight & Fast

  • Minimal resource usage
  • No complex UI or distracting animations
  • Integrates perfectly with Obsidian's performance

🎨 Obsidian Native

  • Matches your theme automatically
  • Uses standard Obsidian UI patterns
  • No external dependencies

🛠️ Highly Configurable

  • Adjust all timer durations
  • Control visual elements
  • Customize work/break cycles

📊 Focus on Productivity

  • No complex analytics or tracking
  • Audio notifications when timers complete (optional)
  • Encourages consistent work habits

Getting Help

  • Common Issues: Check the Troubleshooting guide
  • Bug Reports: Open an issue on GitHub
  • Feature Requests: Discuss on the GitHub repository
  • Development: See the Development Guide for contributing

License & Contributing

PomoBar is open source software released under the MIT License. We welcome contributions! See our Development Guide for details on how to get started.


Ready to boost your productivity? Start with the Installation Guide to get PomoBar set up in your Obsidian vault!