Loved the project? Please consider donating to help it improve!

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

• 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.

The easiest way to install MyDoro is via pip:

pip install mydoro

Start your Pomodoro session from the terminal:

mydoro

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!

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

Main Timer Interface                  Custom Duration Settings

Short Break - Default Theme       Short Break - Monokai Theme

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

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

MIT License — free for personal & commercial use.