MyDoro 🕰️

🕰️ MyDoro — Minimal & Colorful CLI Pomodoro Timer

Welcome to MyDoro! A modern, vibrant, and distraction-free Pomodoro timer for your terminal, built with Python. Boost your productivity with style! ✨

---

🚀 Features

• 🎨 Colorful, modern CLI — Enjoy a visually pleasing experience
• ⏲️ Customizable Pomodoro & break durations
• 🔔 Visual & sound notifications (if supported)
• ⚡ Lightweight & fast
• 🐧 Works on Linux, macOS, and Windows

Note: If you don't hear the bell sound notifications, you may need to configure your terminal's bell sound settings. Most modern terminals allow this in their preferences or settings menu.

---

📦 Installation

From PyPI

The easiest way to install MyDoro is via pip:

pip install mydoro

From Source

Alternatively, you can install from source:

git clone https://github.com/Balaji01-4D/my-doro
cd my-doro
pip install .

---

🛠️ Usage

Start your Pomodoro session from the terminal:

mydoro

Command-line Arguments

Customize your Pomodoro experience with these command-line options:

# Display version information
mydoro --version

# Set custom pomodoro duration (in minutes)
mydoro --pomodoro 30

# Set custom short break duration (in minutes)
mydoro --short-break 8

# Set custom long break duration (in minutes)
mydoro --long-break 20

# Set number of cycles before a long break
mydoro --cycles 4

# Set application theme (options: dracula, monokai, github_dark, github_light)
mydoro --theme monokai

# Combine multiple options
mydoro --pomodoro 30 --short-break 8 --long-break 20 --cycles 4 --theme dracula

Follow the on-screen instructions and enjoy your focused work session! 💪

Keyboard Shortcuts

MyDoro comes with convenient keyboard shortcuts for quick access to features:

Shortcut	Action
m	Open Add Custom Duration screen
Ctrl + p	Open command prompt to change theme
Ctrl + q	Exit application

---

📸 Screenshots

Main Timer Interface                  Custom Duration Settings

Short Break - Default Theme       Short Break - Monokai Theme

---

🎛️ Customization

• Adjust Pomodoro and break durations via settings or command-line arguments (if supported)
• Explore the mydoro/ directory for configuration options

---

🤝 Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

---

📄 License

MIT License — free for personal & commercial use.

---

Made with ❤️ for productivity!