🌲 Pinedoro Timer
Beautiful, minimalist productivity timer with real-time achievement tracking, tree-themed growth visualization, and comprehensive coding activity monitoring.
📋 Table of Contents
🎯 What is Pinedoro?
Pinedoro is a next-generation productivity timer designed specifically for developers. Inspired by the Pomodoro Technique, it transforms your coding sessions into a beautiful tree growth journey with real-time achievement tracking and comprehensive coding activity monitoring.
Unlike other timers, Pinedoro is:
- 🏆 Achievement-Driven with 20+ gamified milestones and progress tracking
- 🌱 Beautifully designed with tree growth metaphors and smooth animations
- 💻 Developer-focused with automatic coding activity and efficiency tracking
- 📊 Comprehensive with detailed productivity statistics and insights
- 🔒 Privacy-first - all data stored locally, no cloud required
- 🎵 Ambient with built-in focus sounds (lofi, rain)
- ⚡ Real-time - instant achievement unlocks and progress updates
- 🎮 Gamified - turn productivity into an engaging growth experience
✨ Key Features
🏆 Advanced Achievement System
- 🎖️ 20+ Gamified Milestones - From "First Sprout" to "Code Legend" with rarity tiers
- 📊 Real-Time Progress Tracking - Live progress bars and completion percentages
- 🏅 Rarity-Based Rewards - Common, Rare, Epic, and Legendary achievements
- 🎯 Categorized Goals - Sessions, Streaks, Time, Coding, Files, Efficiency, and Special
- ⚡ Instant Unlock Notifications - Beautiful popups when you achieve milestones
- 📈 Persistent Progress - Your achievements save and sync across VS Code sessions
- 🎨 Visual Achievement Gallery - Beautiful categorized display with animations
- 🌟 Recent Unlocks Highlighting - See your latest accomplishments prominently
🌳 Stunning Tree Growth Interface
- 🎨 Dedicated Activity Bar Panel - Gorgeous tree view with VS Code native theming
- ✨ Real-time Growth Animation - Smooth animated progress with pulsing effects
- 🌱 Interactive Progress Tracking - seed 🌱 → sprout 🌿 → mature tree 🌳 with color transitions
- 🚀 Quick Action Buttons - One-click access to start sessions, breaks, and custom timers
- ⏰ Live Timer Display - Beautiful progress bars with gradient colors and pulse animations
- 🏆 Achievement Integration - Visual progress toward next milestone
- 💫 Rich Markdown Tooltips - Detailed progress information with beautiful formatting
- 🎯 Contextual Menus - Right-click actions for enhanced productivity workflow
- 🌲 Forest Visualization - Watch your entire productivity forest grow
⏰ Flexible Timer System
- 🌱 Focus Sessions - 25 minutes of deep work
- 🍃 Short Breaks - 5 minutes of rest
- 🌳 Long Breaks - 15 minutes of deep rest
- ⏰ Custom Timers - Any duration you need
- Pause, resume, and reset functionality
💻 Automatic Coding Activity Tracking
- Real-time monitoring of your coding during focus sessions
- Lines of code added, removed, and modified
- Keystrokes and characters typed
- Files edited and programming languages used
- Active coding time vs. thinking time analysis
- Coding efficiency percentage calculations
📊 Rich Analytics Dashboard
- 🌐 Beautiful Webview Panel - Stunning HTML interface with charts and animations
- 📈 Interactive Statistics - Hover effects, gradient charts, and live data updates
- 🏆 Advanced Achievement Gallery - Categorized achievements with progress tracking
- 📊 Weekly Activity Charts - Animated bar charts with shimmer effects and hover interactions
- 🌳 Enhanced Tree Growth Visualization - Interactive forest with recent tree highlighting
- 📁 Advanced Export - Save detailed analytics as JSON with rich formatting
- 🎨 Theme Integration - Seamlessly matches your VS Code theme (dark/light)
- 📱 Responsive Design - Beautiful layout that adapts to panel size
- ⚡ Real-Time Updates - Live data refresh with smooth animations
🎵 Built-in Ambient Sounds
- 🎵 Forest Sounds - Lofi background music for deep focus
- 🌧️ Rain Sounds - Natural rain ambience for calm productivity
- 🔇 Silent Mode - Pure focus without distractions
- 🎧 Quick Sound Menu - Easy switching between audio options
🔒 Privacy-First Design
- 100% local storage - all data stays on your machine
- No cloud sync - no external servers or data collection
- No tracking - your productivity data is yours alone
- Offline-first - works perfectly without internet
📸 Screenshots & Examples
🏆 Achievement System in Action
🏆 ACHIEVEMENT UNLOCKED: Code Apprentice! 🧙♂️
"Write 1,000 lines of code" - You just reached 1,247 lines!
🎖️ Achievement Gallery:
🎯 Focus Sessions (3/5 unlocked)
├── ✅ First Sprout - Complete your first session
├── ✅ Growing Grove - Complete 10 sessions
├── ✅ Dedicated Developer - Complete 50 sessions
├── 🔒 Forest Guardian - 75% (3/4 trees grown)
└── 🔒 Mountain Climber - 20% (5/25 trees grown)
💻 Code Lines (2/5 unlocked)
├── ✅ Code Initiate - 100 lines written
├── ✅ Code Apprentice - 1,000 lines written
├── 🔒 Code Wizard - 45% (4,247/10,000 lines)
├── 🔒 Precision Coder - 12% (4,247/50,000 lines)
└── 🔒 Code Legend - 8% (4,247/100,000 lines)
🌳 Enhanced Tree Growth Interface
🌲 Your Productivity Forest
🌱 Current Session: 85% complete ████████████████░░░
Next: 🌿 Growing Grove (8/10 sessions)
🌳 Forest Overview:
• Trees Grown: 12 🌲
• Current Streak: 7 days 🔥
• Today's Progress: 3 sessions ✅
• Active Coding: 89% efficiency ⚡
🔔 Recent Achievement: "Efficiency Expert" unlocked!
📊 Advanced Analytics Dashboard
📊 Pinedoro Analytics Dashboard v2.0
🌟 Achievement Progress: 8/23 Unlocked (35%)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 35% ████████░░░░░
🏆 RECENT UNLOCKS:
• 💎 Master of Focus - 2 hours ago
• ⚡ Efficiency Expert - 1 day ago
• 🚀 Speed Coder - 3 days ago
📈 Weekly Activity: ████ ███ ████████ ████ ████ ████ ████
Mon Tue Wed Thu Fri Sat Sun
🌲 Interactive Forest: 🌳🌲🎋🌴🎄🌳🌲 (12 trees)
💫 Hover over trees to see growth dates!
⚡ Live Coding Stats:
• Today's Lines: 247 📝
• Keystrokes: 1,580 ⌨️
• Files Edited: 3 📁
• Efficiency: 89% 🚀
• Languages: TypeScript, Python, JSON
🚀 Quick Start
Installation
- Open VS Code
- Go to Extensions (
Ctrl+Shift+X)
- Search for "Pinedoro Timer"
- Click Install
- Start growing your productivity forest! 🌲
First Session
- Open Command Palette (
Ctrl+Shift+P)
- Type "Pinedoro: Start Focus Session"
- Watch the beautiful timer in your status bar
- Code mindfully for 25 minutes
- Enjoy your break and see your growth!
🎮 How to Use
Available Commands
| Command |
Description |
Shortcut |
🌱 Start Focus Session |
Begin 25-min productive coding |
|
🍃 Start Break |
Take a 5-min rest period |
|
🌳 Start Long Break |
Enjoy 15-min deep rest |
|
⏰ Custom Timer |
Set any duration you need |
|
📊 Show Statistics |
View detailed progress stats |
|
📊 Export Statistics |
Save data as JSON file |
|
🎵 Play Forest Sounds |
Enable lofi background |
|
🌧️ Play Rain Sounds |
Enable rain ambience |
|
🎧 Ambient Sound Menu |
Quick sound picker |
|
🌲 Enhanced Tree Growth Panel
The gorgeous sidebar panel features:
- 🌳 Animated Growth Progress - Dynamic tree visualization with color transitions
- 🚀 Quick Action Buttons - One-click focus sessions, breaks, and custom timers
- 📅 Today's Growth Journey - Visual progress bars with percentage completion
- 🏆 Next Milestone Preview - See your upcoming achievements and progress
- 📊 Forest Statistics - Click to open rich analytics dashboard
- 🔥 Streak Visualization - Animated fire effects for active streaks
- 💫 Rich Tooltips - Detailed markdown information on hover
- 🎯 Contextual Actions - Right-click menus for quick commands
✨ Enhanced Status Bar
The beautiful status bar displays:
- 🌱 Animated Tree Icons - Growing tree with session progress
- ⏰ Gradient Progress Bars - Colorful visual progress indicators
- 💫 Pulse Effects - Subtle animations during active sessions
- 🎨 Dynamic Colors - Background changes based on session type and progress
- 📊 Rich Tooltips - Detailed session information with growth stages
- 🎵 Sound Indicators - Visual confirmation of ambient audio
- 🔄 Smart Commands - Context-aware click actions
Keyboard Workflow
# Start your productive day
Ctrl+Shift+P → "Pinedoro: Start Focus Session"
# Take a well-deserved break
Ctrl+Shift+P → "Pinedoro: Start Break"
# Check your amazing progress
Ctrl+Shift+P → "Pinedoro: Show Statistics"
# Add some focus sounds
Ctrl+Shift+P → "Pinedoro: Ambient Sound Menu"
📊 What Gets Tracked
Session Data
- Duration: Planned vs. actual time spent
- Completion: Whether you finished the full session
- Interruptions: How many times you paused/stopped
- Project: Which workspace you were working on
- Sounds: What ambient audio you used
Coding Metrics (Focus Sessions Only)
- Lines Added/Removed/Modified: Track your code changes
- Keystrokes & Characters: Measure typing activity
- Files Edited: See which files you worked on
- Languages Used: Track programming language diversity
- Active Time: Coding time vs. thinking time
- Efficiency: Percentage of session spent actively coding
Productivity Insights
- Daily: Today's focus time, sessions, coding activity
- Weekly: 7-day trends, consistency, best days
- Monthly: Growth patterns, achievements unlocked
- Overall: Lifetime statistics, streaks, trees grown
🏆 Achievement System
🎯 Complete Achievement Gallery
Pinedoro features 23 unique achievements across 8 categories, designed to motivate consistent productivity and celebrate your coding journey.
🎯 Focus Sessions (5 achievements)
- 🟢 First Sprout ⭐ - Complete your first focus session
- 🟢 Growing Grove ⭐ - Complete 10 focus sessions
- 🔵 Dedicated Developer ⭐⭐ - Complete 50 focus sessions
- 🟣 Forest Guardian ⭐⭐⭐ - Grow 5 trees (20 sessions)
- 🟡 Mountain Climber ⭐⭐⭐⭐ - Grow 25 trees (100 sessions)
🔥 Streaks (3 achievements)
- 🔵 Week Warrior ⭐⭐ - Maintain a 7-day streak
- 🟣 Streak Master ⭐⭐⭐ - Maintain a 30-day streak
- 🟡 Consistency Champion ⭐⭐⭐⭐ - Maintain a 100-day streak
⏰ Time Investment (3 achievements)
- 🟢 Hour Hero ⭐ - Complete 25 hours of focused work
- 🔵 Time Lord ⭐⭐ - Complete 100 hours of focused work
- 🟡 Century Master ⭐⭐⭐⭐ - Complete 500 hours of focused work
💻 Code Production (5 achievements)
- 🟢 Code Initiate ⭐ - Write 100 lines of code
- 🟢 Code Apprentice ⭐ - Write 1,000 lines of code
- 🔵 Code Wizard ⭐⭐ - Write 10,000 lines of code
- 🟣 Precision Coder ⭐⭐⭐ - Write 50,000 lines of code
- 🟡 Code Legend ⭐⭐⭐⭐ - Write 100,000 lines of code
📁 File Management (3 achievements)
- 🟢 File Explorer ⭐ - Edit 10 different files
- 🔵 Project Navigator ⭐⭐ - Edit 100 different files
- 🟣 Codebase Master ⭐⭐⭐ - Edit 500 different files
⚡ Efficiency (3 achievements)
- 🔵 Efficiency Expert ⭐⭐ - Achieve 90%+ completion rate
- 🟣 Perfectionist ⭐⭐⭐ - Achieve 95%+ completion rate
- 🟡 Master of Focus ⭐⭐⭐⭐ - Achieve 98%+ completion rate
🚀 Coding Speed (2 achievements)
- 🔵 Speed Coder ⭐⭐ - Achieve 80%+ coding efficiency
- 🟣 Lightning Fast ⭐⭐⭐ - Achieve 90%+ coding efficiency
✨ Special Challenges (3 achievements)
- 🔵 Early Bird ⭐⭐ - Complete 10 sessions before 9 AM
- 🔵 Night Owl ⭐⭐ - Complete 10 sessions after 9 PM
- 🟣 Weekend Warrior ⭐⭐⭐ - Complete 20 weekend sessions
🏅 Rarity System
- ⭐ Common (Gray) - Fundamental milestones
- ⭐⭐ Rare (Blue) - Notable achievements requiring dedication
- ⭐⭐⭐ Epic (Purple) - Significant accomplishments
- ⭐⭐⭐⭐ Legendary (Gold) - Exceptional achievements for productivity masters
🎮 Gamification Features
- 📊 Real-Time Progress - Live progress bars for all achievements
- 🔔 Instant Notifications - Beautiful unlock alerts with celebration
- 📈 Persistent Tracking - Your progress saves across VS Code sessions
- 🎯 Category Organization - Grouped achievements for easy browsing
- ⚡ Achievement Gallery - Visual showcase of your accomplishments
- 🌟 Recent Highlights - See your latest unlocks prominently displayed
🎨 Customization
Themes & Colors
Pinedoro uses your VS Code theme automatically:
- Dark themes: Beautiful contrast with green growth accents
- Light themes: Clean, minimal design with nature colors
- High contrast: Fully accessible design
Sound Options
- 🎵 Forest/Lofi: Gentle background music for focus
- 🌧️ Rain: Natural rain sounds for calm ambience
- 🔇 Silent: Pure focus without audio distractions
Timer Durations
- Focus: 25 minutes (default) or custom duration
- Short Break: 5 minutes or custom
- Long Break: 15 minutes or custom
- Custom Timer: Any duration from 1 minute to 4 hours
📁 Data & Privacy
Local Storage
All your data is stored locally using VS Code's secure storage:
- Sessions: Complete history of all your timer sessions
- Statistics: Calculated metrics and insights
- Preferences: Your sound and timer settings
Export Options
Export your data anytime as JSON:
{
"sessions": [...],
"overall": {...},
"daily": {...},
"weekly": {...},
"monthly": {...}
}
Privacy Guarantee
- ✅ 100% local - no data leaves your machine
- ✅ No tracking - we don't collect any analytics
- ✅ No accounts - no sign-ups or registrations
- ✅ Open source - you can audit the code yourself
- ✅ Offline-first - works without internet
🛠️ Technical Details
System Requirements
- VS Code: Version 1.99.3 or higher
- Operating System: Windows, macOS, or Linux
- Memory: Minimal impact (~5MB)
- Storage: Local data scales with usage (typically <1MB)
- Lightning fast: Near-zero impact on VS Code performance
- Efficient: Smart caching and optimized statistics calculation
- Responsive: Instant UI updates and smooth animations
- Battery friendly: Minimal background processing
File Support
Coding activity tracking works with all file types:
- Popular languages: JavaScript, TypeScript, Python, Java, C#, Go, Rust, etc.
- Web technologies: HTML, CSS, SCSS, JSON, XML, etc.
- Config files: YAML, TOML, INI, etc.
- Documentation: Markdown, RST, etc.
🤝 Contributing
We welcome contributions! Here's how you can help:
Bug Reports
Found a bug? Please report it with:
- Steps to reproduce
- Expected vs. actual behavior
- VS Code version and operating system
- Screenshots if applicable
Feature Requests
Have an idea? We'd love to hear it:
- Describe the feature and use case
- Explain how it fits with the minimalist philosophy
- Provide mockups or examples if possible
Development
Want to contribute code?
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
📖 Philosophy
Pinedoro is built on these core principles:
🌱 Growth Mindset
Productivity is like growing a tree - it takes time, consistency, and care. Every session is progress, every day is growth.
🎯 Mindful Focus
Quality over quantity. Better to have focused, distraction-free sessions than long, unfocused work periods.
🔒 Privacy First
Your productivity data is personal. It should stay on your machine, under your control.
⚡ Minimalist Design
Beautiful, clean interfaces that help rather than distract. Every element serves a purpose.
💻 Developer-Centric
Built by developers, for developers. Understanding the unique needs of coding work.
🎉 Start Your Achievement Journey Today
Ready to transform your productivity into an epic adventure?
- 📥 Install Pinedoro from the VS Code marketplace
- 🌱 Start your first focus session with
Ctrl+Shift+P → "Pinedoro: Start Focus Session"
- 🏆 Unlock your first achievement - "First Sprout" awaits!
- 💻 Code mindfully for 25 minutes while we track your progress
- 🎊 Celebrate milestones as you unlock achievements and grow your forest
- 📊 Explore your analytics to see your productivity evolution
Join the ranks of productivity masters! With 23 unique achievements across 8 categories, every coding session becomes part of your legendary journey.
🌟 Ready to Level Up Your Productivity?
🚀 Install Pinedoro Now
Turn coding into conquest. Grow your forest. Unlock your potential. 🌲⚔️💎
📊 Statistics at a Glance
| Metric |
What it tracks |
| 🏆 Achievements Unlocked |
Progress through 23 unique milestones |
| 🏅 Achievement Rarity |
Common → Rare → Epic → Legendary progression |
| 📊 Real-Time Progress |
Live progress bars for all achievements |
| 🎯 Category Completion |
Progress across 8 achievement categories |
| 🌲 Forest Size |
Trees grown (1 tree = 4 completed sessions) |
| 🔥 Current Streak |
Consecutive days with completed sessions |
| 💻 Lines of Code |
Total code added during focus sessions |
| ⚡ Coding Efficiency |
Active coding time vs. total focus time |
| 📁 Files Edited |
Unique files worked on across projects |
| 🎵 Sound Preferences |
Your favorite ambient audio choices |
| 📅 Session History |
Complete timeline of productivity sessions |
| 🌟 Recent Unlocks |
Latest achievements and milestones reached |
📝 Release Notes
2.0.0 - Achievement Revolution 🎉
- 🏆 Complete Achievement System - 23 gamified milestones with progress tracking
- 🎖️ Rarity-Based Rewards - Common, Rare, Epic, and Legendary achievements
- 📊 Real-Time Progress Monitoring - Live progress bars and completion percentages
- 🔔 Achievement Notifications - Beautiful unlock alerts with celebration
- 🎨 Enhanced Achievement Gallery - Categorized display with animations
- ⚡ Advanced Chart Animations - Interactive weekly charts with hover effects
- 🌲 Improved Tree Animations - Enhanced forest visualization with sparkles
- 📈 Persistent Achievement State - Progress saves across VS Code sessions
- 🎯 Special Time-Based Achievements - Early Bird, Night Owl, Weekend Warrior
- 🚀 Coding Efficiency Tracking - Advanced metrics for coding productivity
- 💎 Legendary Milestones - Code Legend (100K lines), Century Master (500 hours)
1.0.0 - Initial Release
- 🌱 Beautiful tree-themed timer interface
- ⏰ Focus, break, and custom timer functionality
- 💻 Automatic coding activity tracking
- 📊 Comprehensive productivity statistics
- 🎵 Built-in ambient sounds (lofi, rain)
- 📁 Local data storage and JSON export
- 🔒 Privacy-first design with no cloud dependencies
🎮 **Ready for Your Next Achievement?**
Every session brings you closer to legendary status!
🌲 Grow your forest. Unlock achievements. Become legendary. 💎⚔️🏆
Pinedoro Timer v2.0 - Transform productivity into an epic adventure.
