Pomotro - A Desktop Pomodoro Clock

Table of Contents

• Live Preview
• Overview
• Features
• Installation
• Usage
• Windows Releases
• Contributing
• License

Live Preview

Pomotro is a basic and minimalistic Pomodoro Timer for desktop. It helps you stay productive and focused by using the Pomodoro Technique, a time management method that breaks work into intervals, traditionally 25 minutes in length, separated by short breaks.

Overview

Pomotro is inspired by the popular Pomodroid app created by splode, but with a more compact design and simplicity in mind. It is developed by Ranork in their free time, aiming to create a visually pleasing and efficient Pomodoro timer.

Features

• Pomodoro Time Tracking: Monitor your focused work sessions with 25-minute intervals, known as "Pomodoros."
• Break Time Tracking: Keep track of your short breaks between Pomodoros to ensure you take timely and rejuvenating breaks.
• User-Friendly Interface: The app stays always on top and conveniently located in the bottom right corner of your screen for quick access.
• Start/Stop Timer: Easily start or stop the Pomodoro timer to customize your work and break sessions.

Installation

Follow these steps to set up and run Pomotro on your desktop:

1. Clone the repository:

git clone https://github.com/Ranork/Pomotro.git
cd Pomotro

2. Install dependencies:

npm install

Usage

To launch Pomotro, run the following command in your terminal:

npm run start

The app will start, and the timer will appear in the bottom right corner of your screen. Click on the timer to start or stop the Pomodoro session.

Windows Releases

For Windows users, we provide pre-compiled releases that you can directly execute on your machine. Find the latest release under the Releases section. Download the .exe file, and double-click it to launch Pomotro.

Contributing

Contributions to Pomotro are always welcome. If you find a bug or have an idea for an improvement, please open an issue or submit a pull request. Make sure to follow the project's coding style and guidelines.

If you're unsure how to contribute, check out the contribution guidelines.

License

Pomotro is open-source software licensed under the GPL-3.0 License. Feel free to use, modify, and distribute it as per the terms of the license.

---

Thank you for using Pomotro! If you have any questions or feedback, please feel free to contact Ranork.