{"id":14563331,"url":"https://github.com/pimalaya/comodoro","last_synced_at":"2026-02-11T21:02:36.553Z","repository":{"id":43685675,"uuid":"320700273","full_name":"pimalaya/comodoro","owner":"pimalaya","description":"CLI to manage timers","archived":false,"fork":false,"pushed_at":"2026-02-10T21:55:17.000Z","size":267,"stargazers_count":64,"open_issues_count":0,"forks_count":5,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-02-10T23:33:38.941Z","etag":null,"topics":["cli","pimalaya","pomodoro","pomodoro-technique","pomodoro-timer","tcp","tcp-client","tcp-server","timer"],"latest_commit_sha":null,"homepage":"https://pimalaya.org","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pimalaya.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"soywod","ko_fi":"soywod","buy_me_a_coffee":"soywod","liberapay":"soywod","thanks_dev":"soywod","custom":"https://www.paypal.com/paypalme/soywod"}},"created_at":"2020-12-11T22:44:09.000Z","updated_at":"2026-02-10T21:55:22.000Z","dependencies_parsed_at":"2024-02-02T23:23:48.979Z","dependency_job_id":"ab525749-3017-4e24-8907-f176c20b8cd9","html_url":"https://github.com/pimalaya/comodoro","commit_stats":null,"previous_names":["pimalaya/comodoro","soywod/comodoro"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/pimalaya/comodoro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pimalaya%2Fcomodoro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pimalaya%2Fcomodoro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pimalaya%2Fcomodoro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pimalaya%2Fcomodoro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pimalaya","download_url":"https://codeload.github.com/pimalaya/comodoro/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pimalaya%2Fcomodoro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29345396,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T20:11:40.865Z","status":"ssl_error","status_checked_at":"2026-02-11T20:10:41.637Z","response_time":97,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","pimalaya","pomodoro","pomodoro-technique","pomodoro-timer","tcp","tcp-client","tcp-server","timer"],"created_at":"2024-09-07T02:01:52.137Z","updated_at":"2026-02-11T21:02:36.548Z","avatar_url":"https://github.com/pimalaya.png","language":"Rust","funding_links":["https://github.com/sponsors/soywod","https://ko-fi.com/soywod","https://buymeacoffee.com/soywod","https://liberapay.com/soywod","https://thanks.dev/soywod","https://www.paypal.com/paypalme/soywod","https://www.buymeacoffee.com/soywod","https://img.shields.io/badge/-thanks.dev-000000?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQuMDk3IiBoZWlnaHQ9IjE3LjU5NyIgY2xhc3M9InctMzYgbWwtMiBsZzpteC0wIHByaW50Om14LTAgcHJpbnQ6aW52ZXJ0IiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjxwYXRoIGQ9Ik05Ljc4MyAxNy41OTdINy4zOThjLTEuMTY4IDAtMi4wOTItLjI5Ny0yLjc3My0uODktLjY4LS41OTMtMS4wMi0xLjQ2Mi0xLjAyLTIuNjA2di0xLjM0NmMwLTEuMDE4LS4yMjctMS43NS0uNjc4LTIuMTk1LS40NTItLjQ0Ni0xLjIzMi0uNjY5LTIuMzQtLjY2OUgwVjcuNzA1aC41ODdjMS4xMDggMCAxLjg4OC0uMjIyIDIuMzQtLjY2OC40NTEtLjQ0Ni42NzctMS4xNzcuNjc3LTIuMTk1VjMuNDk2YzAtMS4xNDQuMzQtMi4wMTMgMS4wMjEtMi42MDZDNS4zMDUuMjk3IDYuMjMgMCA3LjM5OCAwaDIuMzg1djEuOTg3aC0uOTg1Yy0uMzYxIDAtLjY4OC4wMjctLjk4LjA4MmExLjcxOSAxLjcxOSAwIDAgMC0uNzM2LjMwN2MtLjIwNS4xNTYtLjM1OC4zODQtLjQ2LjY4Mi0uMTAzLjI5OC0uMTU0LjY4Mi0uMTU0IDEuMTUxVjUuMjNjMCAuODY3LS4yNDkgMS41ODYtLjc0NSAyLjE1NS0uNDk3LjU2OS0xLjE1OCAxLjAwNC0xLjk4MyAxLjMwNXYuMjE3Yy44MjUuMyAxLjQ4Ni43MzYgMS45ODMgMS4zMDUuNDk2LjU3Ljc0NSAxLjI4Ny43NDUgMi4xNTR2MS4wMjFjMCAuNDcuMDUxLjg1NC4xNTMgMS4xNTIuMTAzLjI5OC4yNTYuNTI1LjQ2MS42ODIuMTkzLjE1Ny40MzcuMjYuNzMyLjMxMi4yOTUuMDUuNjIzLjA3Ni45ODQuMDc2aC45ODVabTE0LjMxNC03LjcwNmgtLjU4OGMtMS4xMDggMC0xLjg4OC4yMjMtMi4zNC42NjktLjQ1LjQ0NS0uNjc3IDEuMTc3LS42NzcgMi4xOTVWMTQuMWMwIDEuMTQ0LS4zNCAyLjAxMy0xLjAyIDIuNjA2LS42OC41OTMtMS42MDUuODktMi43NzQuODloLTIuMzg0di0xLjk4OGguOTg0Yy4zNjIgMCAuNjg4LS4wMjcuOTgtLjA4LjI5Mi0uMDU1LjUzOC0uMTU3LjczNy0uMzA4LjIwNC0uMTU3LjM1OC0uMzg0LjQ2LS42ODIuMTAzLS4yOTguMTU0LS42ODIuMTU0LTEuMTUydi0xLjAyYzAtLjg2OC4yNDgtMS41ODYuNzQ1LTIuMTU1LjQ5Ny0uNTcgMS4xNTgtMS4wMDQgMS45ODMtMS4zMDV2LS4yMTdjLS44MjUtLjMwMS0xLjQ4Ni0uNzM2LTEuOTgzLTEuMzA1LS40OTctLjU3LS43NDUtMS4yODgtLjc0NS0yLjE1NXYtMS4wMmMwLS40Ny0uMDUxLS44NTQtLjE1NC0xLjE1Mi0uMTAyLS4yOTgtLjI1Ni0uNTI2LS40Ni0uNjgyYTEuNzE5IDEuNzE5IDAgMCAwLS43MzctLjMwNyA1LjM5NSA1LjM5NSAwIDAgMC0uOTgtLjA4MmgtLjk4NFYwaDIuMzg0YzEuMTY5IDAgMi4wOTMuMjk3IDIuNzc0Ljg5LjY4LjU5MyAxLjAyIDEuNDYyIDEuMDIgMi42MDZ2MS4zNDZjMCAxLjAxOC4yMjYgMS43NS42NzggMi4xOTUuNDUxLjQ0NiAxLjIzMS42NjggMi4zNC42NjhoLjU4N3oiIGZpbGw9IiNmZmYiLz48L3N2Zz4="],"categories":["cli"],"sub_categories":[],"readme":"# ⏱ Comodoro [![Releases](https://img.shields.io/github/v/release/pimalaya/comodoro?color=success)](https://github.com/pimalaya/comodoro/releases/latest) [![Repology](https://img.shields.io/repology/repositories/comodoro?color=success)](\"https://repology.org/project/comodoro/versions) [![Matrix](https://img.shields.io/badge/chat-%23pimalaya-blue?style=flat\u0026logo=matrix\u0026logoColor=white)](https://matrix.to/#/#pimalaya:matrix.org) [![Mastodon](https://img.shields.io/badge/news-%40pimalaya-blue?style=flat\u0026logo=mastodon\u0026logoColor=white)](https://fosstodon.org/@pimalaya)\n\nCLI to manage timers\n\n## Table of contents\n\n- [Features](#features)\n- [Installation](#installation)\n  - [Pre-built binary](#pre-built-binary)\n  - [Cargo](#cargo)\n  - [Nix](#nix)\n  - [Sources](#sources)\n- [Configuration](#configuration)\n- [FAQ](#faq)\n- [Social](#social)\n- [Sponsoring](#sponsoring)\n\n## Features\n\n- Centralized server timer controllable by multiple clients at the same time\n- **Multi protocols** (*Unix sockets* and *TCP* only supported for now)\n- Cycles customizable via config file (**Pomodoro** style, **52/17** style, custom)\n- Server and timer hooks customizable via config file (send system notification or run shell command)\n\n*Comodoro CLI is written in [Rust](https://www.rust-lang.org/), and relies on [cargo features](https://doc.rust-lang.org/cargo/reference/features.html) to enable or disable functionalities. Default features can be found in the `features` section of the [`Cargo.toml`](./Cargo.toml#L18), or on [docs.rs](https://docs.rs/crate/comodoro/latest/features).*\n\n## Installation\n\n### Pre-built binary\n\nComodoro CLI can be installed with the `install.sh` installer:\n\n*As root:*\n\n```\ncurl -sSL https://raw.githubusercontent.com/pimalaya/comodoro/master/install.sh | sudo sh\n```\n\n*As a regular user:*\n\n```\ncurl -sSL https://raw.githubusercontent.com/pimalaya/comodoro/master/install.sh | PREFIX=~/.local sh\n```\n\nThese commands install the latest binary from the GitHub [releases](https://github.com/pimalaya/comodoro/releases) section.\n\nIf you want a more up-to-date version than the latest release, check out the [releases](https://github.com/pimalaya/comodoro/actions/workflows/releases.yml) GitHub workflow and look for the *Artifacts* section. You will find a pre-built binary matching your OS. These pre-built binaries are built from the `master` branch.\n\n*Such binaries are built with the default cargo features. If you need more features, please use another installation method.*\n\n### Cargo\n\nComodoro CLI can be installed with [cargo](https://doc.rust-lang.org/cargo/):\n\n```\ncargo install comodoro --locked\n```\n\nWith only server support:\n\n```\ncargo install comodoro --locked --no-default-features --features server\n```\n\nYou can also use the git repository for a more up-to-date (but less stable) version:\n\n```\ncargo install --locked --git https://github.com/pimalaya/comodoro.git\n```\n\n### Nix\n\nComodoro CLI can be installed with [Nix](https://serokell.io/blog/what-is-nix):\n\n```\nnix-env -i comodoro\n```\n\nYou can also use the git repository for a more up-to-date (but less stable) version:\n\n```\nnix-env -if https://github.com/pimalaya/comodoro/archive/master.tar.gz\n```\n\n*Or, from within the source tree checkout:*\n\n```\nnix-env -if .\n```\n\nIf you have the [Flakes](https://nixos.wiki/wiki/Flakes) feature enabled:\n\n```\nnix profile install comodoro\n```\n\n*Or, from within the source tree checkout:*\n\n```\nnix profile install\n```\n\n*You can also run Comodoro directly without installing it:*\n\n```\nnix run comodoro\n```\n\n### Sources\n\nComodoro CLI can be installed from sources.\n\nFirst you need to install the Rust development environment (see the [rust installation documentation](https://doc.rust-lang.org/cargo/getting-started/installation.html)):\n\n```\ncurl https://sh.rustup.rs -sSf | sh\n```\n\nThen, you need to clone the repository and install dependencies:\n\n```\ngit clone https://github.com/pimalaya/comodoro.git\ncd comodoro\ncargo check\n```\n\nNow, you can build Comodoro:\n\n```\ncargo build --release\n```\n\n*Binaries are available under the `target/release` folder.*\n\n## Configuration\n\nThe wizard is not yet available (it should come soon), meanwhile you can manually edit your own configuration from scratch:\n\n- Copy the content of the documented [`./config.sample.toml`](./config.sample.toml)\n- Paste it into a new file `~/.config/comodoro/config.toml`\n- Edit, then comment or uncomment the options you want\n\n## FAQ\n\n### How to debug Comodoro CLI?\n\nThe simplest way is to use `--debug` and/or `--trace` arguments.\n\nThe advanced way is based on environment variables:\n\n- `RUST_LOG=\u003clevel\u003e`: determines the log level filter, can be one of `off`, `error`, `warn`, `info`, `debug` and `trace`.\n- `RUST_BACKTRACE=1`: enables the full error backtrace, which include source lines where the error originated from.\n\nLogs are written to the `stderr`, which means that you can redirect them easily to a file:\n\n```\ncomodoro server start --debug 2\u003e/tmp/comodoro.log\n```\n\n## Social\n\n- Chat on [Matrix](https://matrix.to/#/#pimalaya:matrix.org)\n- News on [Mastodon](https://fosstodon.org/@pimalaya) or [RSS](https://fosstodon.org/@pimalaya.rss)\n- Mail at [pimalaya.org@posteo.net](mailto:pimalaya.org@posteo.net)\n\n## Sponsoring\n\n[![nlnet](https://nlnet.nl/logo/banner-160x60.png)](https://nlnet.nl/)\n\nSpecial thanks to the [NLnet foundation](https://nlnet.nl/) and the [European Commission](https://www.ngi.eu/) that have been financially supporting the project for years:\n\n- 2022: [NGI Assure](https://nlnet.nl/project/Himalaya/)\n- 2023: [NGI Zero Entrust](https://nlnet.nl/project/Pimalaya/)\n- 2024: [NGI Zero Core](https://nlnet.nl/project/Pimalaya-PIM/) *(still ongoing in 2026)*\n\nIf you appreciate the project, feel free to donate using one of the following providers:\n\n[![GitHub](https://img.shields.io/badge/-GitHub%20Sponsors-fafbfc?logo=GitHub%20Sponsors)](https://github.com/sponsors/soywod)\n[![Ko-fi](https://img.shields.io/badge/-Ko--fi-ff5e5a?logo=Ko-fi\u0026logoColor=ffffff)](https://ko-fi.com/soywod)\n[![Buy Me a Coffee](https://img.shields.io/badge/-Buy%20Me%20a%20Coffee-ffdd00?logo=Buy%20Me%20A%20Coffee\u0026logoColor=000000)](https://www.buymeacoffee.com/soywod)\n[![Liberapay](https://img.shields.io/badge/-Liberapay-f6c915?logo=Liberapay\u0026logoColor=222222)](https://liberapay.com/soywod)\n[![thanks.dev](https://img.shields.io/badge/-thanks.dev-000000?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQuMDk3IiBoZWlnaHQ9IjE3LjU5NyIgY2xhc3M9InctMzYgbWwtMiBsZzpteC0wIHByaW50Om14LTAgcHJpbnQ6aW52ZXJ0IiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjxwYXRoIGQ9Ik05Ljc4MyAxNy41OTdINy4zOThjLTEuMTY4IDAtMi4wOTItLjI5Ny0yLjc3My0uODktLjY4LS41OTMtMS4wMi0xLjQ2Mi0xLjAyLTIuNjA2di0xLjM0NmMwLTEuMDE4LS4yMjctMS43NS0uNjc4LTIuMTk1LS40NTItLjQ0Ni0xLjIzMi0uNjY5LTIuMzQtLjY2OUgwVjcuNzA1aC41ODdjMS4xMDggMCAxLjg4OC0uMjIyIDIuMzQtLjY2OC40NTEtLjQ0Ni42NzctMS4xNzcuNjc3LTIuMTk1VjMuNDk2YzAtMS4xNDQuMzQtMi4wMTMgMS4wMjEtMi42MDZDNS4zMDUuMjk3IDYuMjMgMCA3LjM5OCAwaDIuMzg1djEuOTg3aC0uOTg1Yy0uMzYxIDAtLjY4OC4wMjctLjk4LjA4MmExLjcxOSAxLjcxOSAwIDAgMC0uNzM2LjMwN2MtLjIwNS4xNTYtLjM1OC4zODQtLjQ2LjY4Mi0uMTAzLjI5OC0uMTU0LjY4Mi0uMTU0IDEuMTUxVjUuMjNjMCAuODY3LS4yNDkgMS41ODYtLjc0NSAyLjE1NS0uNDk3LjU2OS0xLjE1OCAxLjAwNC0xLjk4MyAxLjMwNXYuMjE3Yy44MjUuMyAxLjQ4Ni43MzYgMS45ODMgMS4zMDUuNDk2LjU3Ljc0NSAxLjI4Ny43NDUgMi4xNTR2MS4wMjFjMCAuNDcuMDUxLjg1NC4xNTMgMS4xNTIuMTAzLjI5OC4yNTYuNTI1LjQ2MS42ODIuMTkzLjE1Ny40MzcuMjYuNzMyLjMxMi4yOTUuMDUuNjIzLjA3Ni45ODQuMDc2aC45ODVabTE0LjMxNC03LjcwNmgtLjU4OGMtMS4xMDggMC0xLjg4OC4yMjMtMi4zNC42NjktLjQ1LjQ0NS0uNjc3IDEuMTc3LS42NzcgMi4xOTVWMTQuMWMwIDEuMTQ0LS4zNCAyLjAxMy0xLjAyIDIuNjA2LS42OC41OTMtMS42MDUuODktMi43NzQuODloLTIuMzg0di0xLjk4OGguOTg0Yy4zNjIgMCAuNjg4LS4wMjcuOTgtLjA4LjI5Mi0uMDU1LjUzOC0uMTU3LjczNy0uMzA4LjIwNC0uMTU3LjM1OC0uMzg0LjQ2LS42ODIuMTAzLS4yOTguMTU0LS42ODIuMTU0LTEuMTUydi0xLjAyYzAtLjg2OC4yNDgtMS41ODYuNzQ1LTIuMTU1LjQ5Ny0uNTcgMS4xNTgtMS4wMDQgMS45ODMtMS4zMDV2LS4yMTdjLS44MjUtLjMwMS0xLjQ4Ni0uNzM2LTEuOTgzLTEuMzA1LS40OTctLjU3LS43NDUtMS4yODgtLjc0NS0yLjE1NXYtMS4wMmMwLS40Ny0uMDUxLS44NTQtLjE1NC0xLjE1Mi0uMTAyLS4yOTgtLjI1Ni0uNTI2LS40Ni0uNjgyYTEuNzE5IDEuNzE5IDAgMCAwLS43MzctLjMwNyA1LjM5NSA1LjM5NSAwIDAgMC0uOTgtLjA4MmgtLjk4NFYwaDIuMzg0YzEuMTY5IDAgMi4wOTMuMjk3IDIuNzc0Ljg5LjY4LjU5MyAxLjAyIDEuNDYyIDEuMDIgMi42MDZ2MS4zNDZjMCAxLjAxOC4yMjYgMS43NS42NzggMi4xOTUuNDUxLjQ0NiAxLjIzMS42NjggMi4zNC42NjhoLjU4N3oiIGZpbGw9IiNmZmYiLz48L3N2Zz4=)](https://thanks.dev/soywod)\n[![PayPal](https://img.shields.io/badge/-PayPal-0079c1?logo=PayPal\u0026logoColor=ffffff)](https://www.paypal.com/paypalme/soywod)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpimalaya%2Fcomodoro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpimalaya%2Fcomodoro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpimalaya%2Fcomodoro/lists"}