git remote set-url origin https://codeberg.org/ichthyosaurus/harbour-minidoro
git fetch
git branch -u origin/main main

This app is modelled after Minidoro for Android by Yury Pavlov. You can get it from F-Droid if you are using Android.

Note: Minidoro requires the “Audio” permission for playing sounds when intervals are started and finished. It never uses the microphone.

How it works

The Pomodoro® Technique is an extremely simple but efficient time management technique developed by Francesco Cirillo.

The basic idea is it's simpler to concentrate on work for a relatively short period, keeping in mind you can take a rest or switch to another activity afterwards.

• Split your work for 25 minute intervals, separated by short break periods.
• In these 25 minute intervals try to focus on your work as much as possible, try to not distract yourself and to avoid other distractions.
• After a 25 minute interval take a 5 minute break. During this break do any other activities except for the previous work.
• Return to the work after the break.
• Take a long break of about 10–30 minutes after every 4 work intervals.

See the website for an in-depth explanation.

Counters

There are two counters at the bottom of the main page. They can be used to count anything. For example, you can count external interruptions with the left counter, while counting internal interruptions (you interrupting yourself) with the right counter. See also this issue.})

You can find screenshots here.

Permissions

Minidoro requires the following Sailjail permissions:

• Audio: for playing sounds when intervals are started and finished

Help and support

You are welcome to leave a comment in the forum if you have any questions or ideas.

Translations

It would be wonderful if the app could be translated in as many languages as possible!

Translations are managed using Weblate. Please prefer this over pull requests (which are still welcome, of course). If you just found a minor problem, you can also open an issue.

Manually updating translations

Please prefer using Weblate over this.

You can follow these steps to manually add or update a translation:

1. If it did not exist before, create a new catalog for your language by copying the base file translations/harbour-minidoro.ts. Then add the new translation to harbour-minidoro.pro.
2. Add yourself to the list of translators in TRANSLATORS.json, in the section extra.
3. (optional) Translate the app's name in harbour-minidoro.desktop if there is a (short) native term for it in your language.

See the Qt documentation for details on how to translate date formats to your local format.

Building and contributing

Bug reports, and contributions for translations, bug fixes, or new features are always welcome!

1. Clone the repository by running git clone --recursive https://codeberg.org/ichthyosaurus/harbour-minidoro
2. Open harbour-minidoro.pro in QtCreator for Sailfish (SailfishOS SDK)
3. To run on emulator, select the i486 target and press the run button
4. To build for the device, select the aarch64 or armv7hl target and click “deploy all”; the RPM packages will be in the RPMS folder

If you contribute, please do not forget to add yourself to the list of contributors in qml/pages/AboutPage.qml!

Donations

I am always happy if you buy me a cup of coffee through Liberapay if you want to support my work.

Of course it would be much appreciated as well if you support this project by contributing to translations or code! See above how you can contribute 🎕.

Please consider also supporting the SailfishOS Community Team on Liberapay to reach more developers.

Anti-AI policy

Please be transparent, respect the Free Software community, and adhere to the licenses. This is a welcoming place for human creativity and diversity, but LLM/“AI”-generated slop is going against these values.

Apart from all the ethical, moral, legal, environmental, societal, social, political, technical, and overall human, reasons against LLMs/“AI”, I also simply don't have any spare time to review generated contributions.

See also this list for more reasons against supporting “AI”.

License

Copyright (C) 2022-2026 Mirian Margiani

Minidoro is Free Software released under the terms of the GNU Affero General Public License v3 (or later). The source code is available on Codeberg. All documentation is released under the terms of the GNU Free Documentation License v1.3 (or later).

Minidoro and related materials must not be used for AI training and/or data mining.

This project follows the REUSE specification.