🌲 Pinedoro Timer

Beautiful, minimalist productivity timer with tree-themed growth visualization and comprehensive coding activity tracking.

🎯 What is Pinedoro?

Pinedoro is a minimalist productivity timer designed specifically for developers. Inspired by the Pomodoro Technique, it transforms your coding sessions into a beautiful tree growth journey while tracking comprehensive statistics about your productivity and coding activity.

Unlike other timers, Pinedoro is:

🌱 Beautifully designed with tree growth metaphors and clean animations
💻 Developer-focused with automatic coding activity tracking
📊 Comprehensive with detailed productivity statistics
🔒 Privacy-first - all data stored locally, no cloud required
🎵 Ambient with built-in focus sounds (lofi, rain)
⚡ Minimalist - zero distractions, pure productivity

✨ Key Features

🌳 Tree-Themed Growth Visualization

Watch your productivity grow like a beautiful tree
Visual progress with seed 🌱 → sapling 🌿 → tree 🌳 animations
"Trees grown" metric (1 tree per 4 completed focus sessions)
Minimalist, distraction-free interface

⏰ 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

📊 Comprehensive Statistics

Daily stats: Today's productivity, coding metrics, and achievements
Weekly trends: 7-day rolling statistics and consistency tracking
Monthly insights: Growth patterns and achievement unlocks
Overall progress: Lifetime productivity metrics and records
Export functionality: Save all data as JSON for backup/analysis

🎵 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

Timer in Action

🌱 Focus Session → 20:45 remaining ████████████░░░░░ 🎵
Active coding: 127 lines • 892 keystrokes • 3 files

Statistics Dashboard

📊 Pinedoro Growth Statistics

🌱 Today:
• Focus Time: 120 minutes
• Sessions: 5 completed  
• Productivity: 83%
• Lines Added: 247 📝
• Keystrokes: 1,580 ⌨️
• Files Edited: 3 📁
• Languages: typescript, javascript 💻

🌳 Overall Growth:
• Total Sessions: 156
• Focus Hours: 78 hours
• Trees Grown: 39 🌳
• Lines of Code: 8,247 📝
• Coding Efficiency: 67% ⚡

🚀 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

Status Bar Integration

The beautiful status bar shows:

Current session with tree growth animation
Remaining time with visual progress bar
Coding activity (lines, keystrokes, files) on hover
Sound indicator when ambient audio is playing

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

🏆 Achievements & Gamification

Unlock achievements as you grow your productivity forest:

🌱 First Sprout - Complete your first focus session
🌿 Consistent Grower - Maintain 80%+ weekly consistency
🌳 Century Focus - Reach 100+ hours of total focus time
🌿 Weekly Warrior - Average 20+ hours per week
🔥 Fire Streak - Maintain a 7+ day completion streak
💻 Code Master - Write 10,000+ lines of code
⚡ Efficiency Expert - Achieve 90%+ coding efficiency

🎨 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.104.0 or higher
Operating System: Windows, macOS, or Linux
Memory: Minimal impact (~5MB)
Storage: Local data scales with usage (typically <1MB)

Performance

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.

🎉 Get Started Today

Ready to transform your productivity?

Install Pinedoro from the VS Code marketplace
Start your first focus session with Ctrl+Shift+P → "Pinedoro: Start Focus Session"
Code mindfully for 25 minutes and watch your tree grow
Take breaks and celebrate your progress
Track your growth with beautiful statistics

Join thousands of developers who have grown their productivity forest with Pinedoro! 🌲✨

📊 Statistics at a Glance

Metric	What it tracks
Focus Time	Total minutes in focus sessions
Sessions Completed	Number of successful focus periods
Current Streak	Consecutive days with completed sessions
Trees Grown	Visual progress indicator (1 tree = 4 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
Languages Used	Programming languages diversity

📝 Release Notes

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

Happy coding and mindful productivity! 🌲💻✨

Pinedoro Timer - Grow your productivity, one session at a time.

Pinedoro Timer

singularity-tech