🎮 Game Time Tracker

A lightweight and modern game session logger with focus-aware stats.

---

📌 Overview

Game Time Tracker (Dynamic Mode) is a desktop application to track your game sessions, playtime, and focus using only your game's .exe name.

It helps you:

• Understand your play habits
• Stay mindful of gaming time
• Log accurate session durations
• Track daily and total usage

---

💡 Features

• 🔍 Dynamic Game Detection
  Enter any .exe name—no setup or integrations required.

• 📊 Session Analytics

  • Total playtime (hours)
  • Average session duration
  • Daily session length

• 🧠 Focus Score System

  • Color-coded (🟢🟠🔴) feedback based on daily usage target (2 hours/day)
  • Visual indicators help reduce screen overuse

• 💾 Session Logging

  • All game activity is stored locally in sessions.db (SQLite)
  • Persistent session history

• 🖥️ Modern GUI

  • Responsive and clean Tkinter interface
  • Dark mode, elegant fonts, color-coded metrics
  • GitHub link and license embedded in the footer

---

✅ Version 1.0 Includes

• Support for any .exe name
• Real-time tracking and updates
• Local database session saving
• Stats dashboard with session summaries
• Daily focus goal calculation
• Exportable, customizable source

---

🛠 Tech Stack

• Python 3.10+
• tkinter (for GUI)
• psutil (for detecting processes)
• sqlite3 (for saving sessions)
• threading (for non-blocking logic)

---

🚀 Getting Started

1. Clone or download this repository
2. Run main.py
3. Enter your game’s .exe name (e.g., Cyberpunk2077.exe)
4. Start playing — the app will track everything automatically

To build an .exe, use PyInstaller (see docs for more).

---

📚 Documentation

• Code is clean, modular, and beginner-friendly
• Functions are documented inline
• Refer to main.py and tracker.py for core logic
• All logic uses standard Python libraries, no complex dependencies

---

🙌 Contributors

👤 Lead Developer

Krishnamohan Yagneswaran
🔗 GitHub

---

👥 Become a Contributor

Want to contribute? Here’s how:

• Fork the repo
• Make changes and improvements
• Submit a Pull Request (PR)
• Get listed here once merged!

---

❤️ Support & Donations

If you enjoy using this tool, consider supporting development:

• ☕ Buy Me a Coffee
• 💳 Donate via Razorpay

Your support keeps this project open and maintained.

---

📄 License

MIT License – Non-Commercial Use Only
© 2025 Krishnamohan Yagneswaran

You are free to use, modify, and share this software for personal or educational purposes.
Commercial use or resale is strictly prohibited without prior permission.

All copies must include this license notice.

---

🌟 Star this repo if you find it useful. Contributions welcome!
GitHub Repo ↗