# 🍅 Comodoro [](https://crates.io/crates/comodoro) [](https://matrix.to/#/#pimalaya.comodoro:matrix.org)
https://pimalaya.org/comodoro/
CLI to manage your time using the
[Pomodoro](https://en.wikipedia.org/wiki/Pomodoro_Technique)
technique, based on the
[pimalaya-pomodoro](https://sr.ht/~soywod/pimalaya/) library.
*Disclaimer: the project is under active development, do not use in
production before the `v1.0.0`.*
## Features
- Centralized server timer controllable by multiple clients at the
same time
- Multi protocols (only TCP for now, but you can build your own)
- Work and break durations customizable via config file
- Server and timer hooks customizable via config file
- …
## Installation
<table align="center">
<tr>
<td width="50%">
<a href="https://repology.org/project/comodoro/versions">
<img src="https://repology.org/badge/vertical-allrepos/comodoro.svg" alt="Packaging status" />
</a>
</td>
<td width="50%">
```bash
# Cargo
$ cargo install comodoro
# Nix
$ nix-env -i comodoro
```
*See the
[documentation](https://pimalaya.org/comodoro/cli/installation.html)
for other installation methods.*
</td>
</tr>
</table>
## Configuration
Please read the
[documentation](https://pimalaya.org/comodoro/cli/configuration.html).
## Contributing
If you find a **bug** that [does not exist
yet](https://todo.sr.ht/~soywod/pimalaya), please send an email at
[~soywod/pimalaya@todo.sr.ht](mailto:~soywod/pimalaya@todo.sr.ht).
If you have a **question**, please send an email at
[~soywod/pimalaya@lists.sr.ht](mailto:~soywod/pimalaya@lists.sr.ht).
If you want to **propose a feature** or **fix a bug**, please send a
patch at
[~soywod/pimalaya@lists.sr.ht](mailto:~soywod/pimalaya@lists.sr.ht)
using [git send-email](https://git-scm.com/docs/git-send-email) (see
[this guide](https://git-send-email.io/) on how to configure it).
If you want to **subscribe** to the mailing list, please send an email
at
[~soywod/pimalaya+subscribe@lists.sr.ht](mailto:~soywod/pimalaya+subscribe@lists.sr.ht).
If you want to **unsubscribe** to the mailing list, please send an
email at
[~soywod/pimalaya+unsubscribe@lists.sr.ht](mailto:~soywod/pimalaya+unsubscribe@lists.sr.ht).
If you want to **discuss** about the project, feel free to join the
[Matrix](https://matrix.org/) workspace
[#pimalaya.comodoro](https://matrix.to/#/#pimalaya.comodoro:matrix.org)
or contact me directly
[@soywod](https://matrix.to/#/@soywod:matrix.org).
## Credits
- [Francesco Cirillo](https://francescocirillo.com/), the creator of
the Pomodoro technique
- [Wikipedia](https://en.wikipedia.org/wiki/Pomodoro_Technique)
- [pomodoro-technique.fr](http://www.pomodoro-technique.fr/)
- [pymodoro](https://github.com/rogeralmeida/pymodoro), a python CLI
## Sponsoring
[](https://github.com/sponsors/soywod)
[](https://www.paypal.com/paypalme/soywod)
[](https://ko-fi.com/soywod)
[](https://www.buymeacoffee.com/soywod)
[](https://liberapay.com/soywod)