🍅 Pomodoro Focus Timer - Desktop Application

ස්ථාපනය (Installation)

මේ desktop application එක භාවිතා කරන්න කිසිම software එකක් install කරන්න ඕන නෑ! This desktop application works WITHOUT installing any additional software!

---

භාවිතය (How to Use)

Method 1: Double-Click Launch (Easy!)

1. Double-click මේ file එක: Launch Pomodoro Timer.bat
2. Desktop application එක automatically open වෙයි!

Method 2: Direct Launch

1. Double-click මේ file එක: PomodoroTimer.hta
2. Timer එක desktop window එකක open වෙයි!

---

විශේෂාංග (Features)

✅ Custom Timer Settings - Hours සහ Minutes set කරන්න පුළුවන් ✅ Beautiful Circular Progress - Animated progress ring ✅ Fullscreen Mode - Distraction-free focus mode ✅ Ambient Rain Sounds - Focus වෙන්න rain sounds ✅ Spotify Integration - Focus music play කරන්න ✅ To-Do List - Tasks track කරන්න ✅ Statistics Tracking - Pomodoros, time, streaks track කරයි ✅ Desktop Notifications - Timer complete වෙද්දී alerts

---

ගැටළු විසඳීම (Troubleshooting)

Application එක open වෙන්නේ නෑ?

• Windows Security warning එකක් එනවා නම්, "Run anyway" click කරන්න
• Right-click කරලා "Open" select කරන්න

Spotify player එක load වෙන්නේ නෑ?

• Internet connection එක check කරන්න
• Browser එකේ open කරලා Spotify login වෙලා තියෙනවද බලන්න

---

Files

• PomodoroTimer.hta - Main desktop application
• Launch Pomodoro Timer.bat - Easy launcher
• index.html - Web version (browser එකේ open කරන්න පුළුවන්)
• style.css - Styling
• script.js - Application logic

---

System Requirements

• Operating System: Windows 7 or higher
• Internet: For Spotify and Google Fonts (optional)
• No additional software needed!

---

Desktop App vs Web Version

Feature	Desktop App (.hta)	Web Version (.html)
Standalone Window	✅ Yes	❌ Browser Tab
Always on Top	✅ Yes	❌ No
Taskbar Icon	✅ Yes	❌ No
Installation Required	❌ No	❌ No
Works Offline	⚠️ Partial	⚠️ Partial

---

Tips for Best Experience

1. Pin to Taskbar: Right-click launcher → Pin to taskbar
2. Create Desktop Shortcut: Right-click Launch Pomodoro Timer.bat → Send to → Desktop
3. Focus Mode: Use fullscreen mode for distraction-free work
4. Set Custom Times: Adjust hours and minutes for different work sessions

---

Technical Details

This is an HTA (HTML Application) - a Windows-native format that runs HTML/CSS/JavaScript as a desktop application using Internet Explorer's rendering engine (built into Windows).

Advantages:

• ✅ No installation required
• ✅ Native Windows application
• ✅ Small file size
• ✅ Works on all Windows versions
• ✅ No dependencies

---

Support

මෙම application එක භාවිතා කරන්න ගැටළු තියෙනවා නම්, කරුණාකර කියන්න! If you have any issues using this application, please let me know!

---

Built with ❤️ for productivity