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

---

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

---

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.