A comprehensive productivity plugin that combines the Pomodoro Technique with integrated note-taking and background music, all within your Obsidian workspace.
- Customizable work sessions (default: 25 minutes)
- Short and long breaks (default: 5 and 15 minutes)
- Visual progress indicators with beautiful gradients
- Audio notifications when sessions complete
- Auto-start options for seamless workflow
- Embedded YouTube player for playlists or individual videos
- Easy URL configuration
- Persistent music settings
- Seamless integration with your workflow
- Modern gradient-based interface
- Responsive design for all screen sizes
- Smooth animations and hover effects
- Dark theme support
- Clean, distraction-free layout
- Download the plugin files
- Copy them to your Obsidian plugins folder:
VaultFolder/.obsidian/plugins/pomodoro-productivity/ - Enable the plugin in Obsidian settings
- Click the clock icon in the ribbon or use the command palette
- Open the plugin by clicking the clock icon in the ribbon
- Configure your YouTube playlist URL in the music section
- Set your session notes and next session plan
- Click "Start" to begin your first Pomodoro session
Access plugin settings through Obsidian's settings panel:
- Timer Durations: Customize work, break, and long break periods
- Session Count: Set how many work sessions before a long break
- Notifications: Enable/disable completion alerts
- Auto-start: Automatically begin breaks after work sessions
- Notes Folder: Choose where session notes are saved
- Music URL: Set your default YouTube playlist
- Plan Ahead: Use the "next session plan" to maintain focus
- Review Progress: Check your daily Pomodoro files to see accomplishments
- Customize Timers: Adjust durations based on your attention span
- Background Music: Choose instrumental or lo-fi music to avoid distraction
- Take Real Breaks: Step away from your computer during break periods
YouTube not loading?
- Ensure you're using a valid YouTube URL
- Check your internet connection
- Try switching between playlist and individual video URLs
Notes not saving?
- Verify the notes folder exists or leave empty for vault root
- Check Obsidian permissions
- Ensure you have write access to your vault
Timer not working?
- Restart Obsidian if the plugin seems unresponsive
- Check that the plugin is enabled in settings
Found a bug or have a feature request? Please open an issue or submit a pull request on GitHub.
MIT License - feel free to modify and distribute as needed.
Happy productivity! 🍅✨