{"id":31794334,"url":"https://github.com/jorbush/rusty_pomo","last_synced_at":"2025-10-10T19:29:42.969Z","repository":{"id":308933112,"uuid":"1034620811","full_name":"jorbush/rusty_pomo","owner":"jorbush","description":"a minimalist CLI pomodoro built in Rust","archived":false,"fork":false,"pushed_at":"2025-08-08T18:09:52.000Z","size":1108,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-08T19:39:20.204Z","etag":null,"topics":["cli","pomodoro","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jorbush.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-08-08T17:33:53.000Z","updated_at":"2025-08-08T18:09:56.000Z","dependencies_parsed_at":"2025-08-08T19:51:06.371Z","dependency_job_id":null,"html_url":"https://github.com/jorbush/rusty_pomo","commit_stats":null,"previous_names":["jorbush/rusty_pomo"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/jorbush/rusty_pomo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorbush%2Frusty_pomo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorbush%2Frusty_pomo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorbush%2Frusty_pomo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorbush%2Frusty_pomo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jorbush","download_url":"https://codeload.github.com/jorbush/rusty_pomo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorbush%2Frusty_pomo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279005038,"owners_count":26083827,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","pomodoro","rust"],"created_at":"2025-10-10T19:29:40.595Z","updated_at":"2025-10-10T19:29:42.965Z","avatar_url":"https://github.com/jorbush.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Rusty Pomo\n\nMinimalist, visually pleasing Pomodoro timer in your terminal. Built with Rust, Ratatui, and Crossterm.\n\n![Rusty Pomo](assets/rusty_pomo.png)\n\n### Features\n- Configurable durations for focus, short break, and long break\n- Simple, clean TUI with a progress gauge\n- Three themes: `dracula`, `solarized-dark`, `gruvbox-dark`\n- Desktop notifications with optional sound and custom duration\n- macOS bundle-id support so notifications can use your app icon\n\n### Prerequisites\n- Rust toolchain: `rustup` + `cargo` (`rustc --version` should work)\n\n### Run\n```bash\ncargo run\n```\n\nWith custom options:\n```bash\ncargo run -- \\\n  --focus 50 --short 10 --long 20 --long-every 4 \\\n  --theme gruvbox-dark \\\n  --notification-sound Ping \\\n  --notification-seconds 15\n```\n\nDisable notifications:\n```bash\ncargo run -- --notifications=false\n```\n\n### Keybindings\n- Space: pause/resume\n- n: next phase\n- r: reset current phase\n- q or Esc: quit\n\n### CLI options\n```text\n--focus \u003cMIN\u003e               Focus minutes (default: 25)\n--short \u003cMIN\u003e               Short break minutes (default: 5)\n--long \u003cMIN\u003e                Long break minutes (default: 15)\n--long-every \u003cN\u003e            Number of focus sessions before a long break (default: 4)\n--theme \u003cTHEME\u003e             Theme (default: dracula)  [dracula, solarized-dark, gruvbox-dark]\n--notifications \u003cBOOL\u003e      Enable desktop notifications (default: true)\n--notification-sound \u003cS\u003e    Sound name (platform-specific)\n--notification-seconds \u003cS\u003e  Notification duration in seconds (default: 10; macOS ignores)\n--macos-bundle-id \u003cID\u003e      macOS only: bundle identifier to attribute notifications to\n```\n\nNotes:\n- Common macOS sounds include `Ping`, `Submarine`; on Linux, try `message-new-instant`.\n- macOS ignores per-notification icons and timeouts; see section below for using your own app icon.\n\n### macOS notifications with the rusty pomo icon\nmacOS will always use the icon of the app bundle posting the notification. To see the Rusty Pomo logo in notifications, bundle the app and pass the bundle identifier. Step-by-step instructions are in:\n\n- docs: `docs/macos-notifications.md`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjorbush%2Frusty_pomo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjorbush%2Frusty_pomo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjorbush%2Frusty_pomo/lists"}