Productivity-Bot

A Telegram bot that helps users stay organized and efficient using the Pomodoro Technique.

How It Works

This bot implements the Pomodoro Technique for time management:

Pomodoro Technique

• Work Session: 25 minutes of focused work
• Break Time: 7 minutes of rest after each work session
• Session Tracking: All sessions are logged to a CSV file with timestamps

Core Functionality

1. Start a Pomodoro Session

   • Command: /pomodoro <topic>
   • Example: /pomodoro Study Math
   • Starts a 25-minute focused work session on the specified topic
   • Bot will notify you when the session is complete
   • Automatically starts a 7-minute break after completion

2. Check Session Status

   • Command: /pomodoro status
   • Shows current session information
   • Displays remaining time for work or break period

3. Clear/Stop Session

   • Command: /pomodoro clear
   • Stops the current session and clears all timers
   • Logs the session as "stopped" in the CSV file

4. Bot Initialization

   • Command: /start
   • Confirms the bot is running and ready to use

Session Management

• One Session Per User: Only one active session allowed at a time
• Session Logging: All sessions are logged to output.csv with:
  • Topic name
  • Timestamp
  • Status (started/completed/stopped)

Automated Notifications

• Pomodoro Complete: Bot sends "Pomodoro done! Take a break! ☕" after 25 minutes
• Break Complete: Bot sends "Break done! Back to work! 🎯" after 7 minutes
• Session automatically removes itself after break completion

Technical Details

• Built with Python using python-telegram-bot library
• Uses threading for timer management
• Environment variables for secure token storage (.env file)
• CSV logging system for session tracking
• Asynchronous message handling for reliable notifications