{"id":13406308,"url":"https://github.com/zidoro/pomatez","last_synced_at":"2025-05-14T14:09:49.729Z","repository":{"id":38201553,"uuid":"206254792","full_name":"zidoro/pomatez","owner":"zidoro","description":"Stay Focused. Take a Break.","archived":false,"fork":false,"pushed_at":"2024-09-20T02:21:51.000Z","size":55388,"stargazers_count":4266,"open_issues_count":165,"forks_count":177,"subscribers_count":37,"default_branch":"master","last_synced_at":"2025-04-10T11:02:05.374Z","etag":null,"topics":["pomodoro","pomodoro-app","pomodoro-clock","pomodoro-technique","pomodoro-timer","productivity","productivity-app","productivity-booster","productivity-timer","productivity-tool","time-management","time-management-app","time-management-tool","tomato","tomato-clock","tomato-timer"],"latest_commit_sha":null,"homepage":"https://zidoro.github.io/pomatez/","language":"TypeScript","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/zidoro.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"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}},"created_at":"2019-09-04T07:07:53.000Z","updated_at":"2025-04-09T16:35:17.000Z","dependencies_parsed_at":"2023-02-15T11:01:39.700Z","dependency_job_id":"a5d4ebda-75f8-4f3f-a7e8-4f11cb3e57d5","html_url":"https://github.com/zidoro/pomatez","commit_stats":null,"previous_names":["roldanjr/pomatez"],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zidoro%2Fpomatez","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zidoro%2Fpomatez/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zidoro%2Fpomatez/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zidoro%2Fpomatez/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zidoro","download_url":"https://codeload.github.com/zidoro/pomatez/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254160514,"owners_count":22024570,"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","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":["pomodoro","pomodoro-app","pomodoro-clock","pomodoro-technique","pomodoro-timer","productivity","productivity-app","productivity-booster","productivity-timer","productivity-tool","time-management","time-management-app","time-management-tool","tomato","tomato-clock","tomato-timer"],"created_at":"2024-07-30T19:02:26.806Z","updated_at":"2025-05-14T14:09:44.711Z","avatar_url":"https://github.com/zidoro.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","productivity"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://zidoro.github.io/pomatez/\"\u003e\n    \u003cimg src=\".github/assets/logo.png\" alt=\"Pomatez logo\" width=\"56\" height=\"56\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003ePomatez\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003eStay Focused. Take a Break.\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003ca href=\"#sparkles-features\"\u003eFeatures\u003c/a\u003e\n  .\n  \u003ca href=\"https://discord.gg/ZqPqN3hwcB\" target=\"_blank\"\u003eDiscord\u003c/a\u003e\n  .\n  \u003ca href=\"#call_me_hand-development\"\u003eDevelopment\u003c/a\u003e\n  .\n  \u003ca href=\"#computer-installation\"\u003eInstallation\u003c/a\u003e\n  .\n  \u003ca href=\"#shield-privacy\"\u003ePrivacy\u003c/a\u003e\n  .\n  \u003ca href=\"#newspaper-license\"\u003eLicense\u003c/a\u003e\n  \u003cbr\u003e\n  \u003cbr\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n   \u003ca href=\"https://snapcraft.io/pomatez\"\u003e\n      \u003cimage src=\"https://snapcraft.io/pomatez/badge.svg\" alt=\"Pomatez\" /\u003e\n   \u003c/a\u003e\n   \u003cimage src=\"https://img.shields.io/github/downloads/zidoro/pomatez/total\" alt=\"Github Downloads\" /\u003e\n   \u003ca href=\"https://github.com/zidoro/pomatez/releases/latest\"\u003e\n      \u003cimage src=\"https://img.shields.io/github/v/release/zidoro/pomatez\" alt=\"Latest Version\" /\u003e\n   \u003c/a\u003e\n   \u003ca href=\"https://github.com/zidoro/pomatez/blob/master/LICENSE\"\u003e\n      \u003cimage src=\"https://img.shields.io/github/license/zidoro/pomatez\" alt=\"License\" /\u003e\n   \u003c/a\u003e\n\u003c/p\u003e\n\n![App Preview](.github/assets/preview.png)\n\n## :sparkles: Features\n\n- **Customizable rules** - it allows you to modify the default Pomodoro configuration based on your personal preferences.\n\n- **Built-in task list** - it allows you to create a simple list of todos and mark the items done when it's done.\n\n- **Full-screen breaks** - once enabled, it will force you to not continue working during break time by occupying the whole screen of your desktop, but right now it doesn't support multiple monitors.\n\n- **Desktop notification** - once enabled, you will get desktop notifications from time to time depending on the notification type you selected. Supported notification types are the following;\n\n  - _None_ - no notification will be shown. `default`\n  - _Normal_ - will show notification in every break.\n  - _Extra_ - will show notification 60 seconds before the break starts, and 30s before the break ends, and the actual break starts.\n\n- **Special breaks** - a special feature that enables you to set specific times to take important breaks like lunch, snack, dinner and etc.. without updating the Pomodoro configuration.\n\n- **Keyboard shortcuts** - might be helpful for you depending on your use case but currently, these keyboard shortcuts are not yet customizable.\n\n- **Auto updates** - the app will automatically check for updates and download them in the background. You will be notified when the update is ready to be installed.\n\n- **Always on top** - once enabled, the app will always be on top of other apps running on your Operating System.\n\n- **Minimize to tray** - once enabled, the minimize action will not minimize the app. Instead, it will be hidden and sent to the tray.\n\n- **Close to tray** - once enabled, the close action will not quit the app. Instead, it will be hidden and sent to the tray.\n\n- **Progress on tray** - the app will show a progress indicator on your system tray. This feature can be activated if minimize to tray or close to tray feature is enabled also.\n\n- **Progress animation** - by default, you will get a smooth timer progress animation but if you're worried about the app's memory consumption on your computer, you can disable it by the way.\n\n- **Toggle native titlebar** - it allows you to switch between the custom title bar of the app to a native one provided by your Operating System and vice versa, depending on your personal preference.\n\n- **Auto-start work time** - once enabled, you will no longer need to manually start the work timer again after the break ends, it will automatically start for you.\n\n- **Voice assistance** - once enabled, your desktop notification will include a male voice to inform you of things related to your Pomodoro session. Useful sometimes especially when you're away from your computer during break time.\n\n- **Dark theme** - it allows you to use dark mode and helps you reduce eye strain and improves visibility if you are the type of person with low vision and high sensitivity to bright light.\n\n- **Strict mode** - once enabled, the app will strictly follow the rules you have set and prevent you from pausing, skipping, and resetting the timer when it started.\n\n- **Compact Mode** - once enabled, the app will occupy less space on your screen and it will be useful if you're using a small-screen device.\n\n## :zap: Quick Setup\n\n### :page_with_curl: Prerequisites\n\n1. You need to have `node` v18 and `npm` v8 installed on your machine. If you don't have it yet, you can install it by running the following command.\n\n   1. For Mac\n\n      ```bash\n      brew install node\n      ```\n\n   2. For Windows\n\n      ```bash\n      choco install nodejs\n      ```\n\n   3. For Linux\n\n      ```bash\n      sudo apt install nodejs\n      ```\n\n   4. Using [Node Version Manager](https://github.com/nvm-sh/nvm) (Recommended)\n\n      ```bash\n      # Inside the project directory\n      nvm install \u0026\u0026 nvm use\n      ```\n\n      To automatically switch to the correct node version when you enter the project directory, just follow the details [here](https://github.com/nvm-sh/nvm#deeper-shell-integration).\n\n   Or you can download it from [here](https://nodejs.org/en/download/).\n\n2. You need to have `yarn` globally installed on your machine. If you don't have it yet, you can install it by running the following command.\n\n   1. For Mac\n\n      ```bash\n      brew install yarn\n      ```\n\n   2. For Windows\n\n      ```bash\n      choco install yarn\n      ```\n\n   3. For Linux\n\n      ```bash\n      sudo apt install yarn\n      ```\n\n   4. Using npm\n\n      ```bash\n      npm install -g yarn\n      ```\n\n### :package: Installation\n\n1. Install all app dependencies.\n\n   ```sh\n   yarn install\n   ```\n\n2. Start the development.\n\n   ```sh\n   yarn dev:app\n   ```\n\n### 🛠 Building for Production\n\n1. Build Windows installer.\n\n   ```sh\n   yarn build:win\n   ```\n\n2. Build macOS installer.\n\n   ```sh\n   yarn build:mac\n   ```\n\n3. Build Linux installer.\n\n   ```sh\n   yarn build:linux\n   ```\n\n4. Build macOS, Windows and Linux installer at once.\n\n   ```sh\n   yarn build:mwl\n   ```\n\n## :pencil: Pre-Commit\n\nIf your pr is being rejected due to the pre-commit checks, just download pre-commit using `pip install pre-commit` or via one of the commands [here](https://pre-commit.com/#install).\nOnce that is installed just running `pre-commit` should automatically fix the files.\n\n## :computer: Installation\n\nAvailable for Windows, macOS, and Linux.\n\nDownload the latest version from the [Releases Page](https://github.com/zidoro/pomatez/releases/latest) or from the :point_right: [Download Page](https://zidoro.github.io/pomatez/) .\n\n**For Linux users:**\n\n\u003e If you want to be always updated with the latest release, recommended way to install it is via Snap Store.\n\n[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/pomatez)\n\nPlease consider starring this project to show your :blue_heart: and support. Thank you so much :bowing_man:\n\n## :newspaper: License\n\nMIT © [Roldan Montilla Jr](https://github.com/roldanjr)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzidoro%2Fpomatez","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzidoro%2Fpomatez","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzidoro%2Fpomatez/lists"}