Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zidoro/pomatez
Stay Focused. Take a Break.
https://github.com/zidoro/pomatez
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
Last synced: about 19 hours ago
JSON representation
Stay Focused. Take a Break.
- Host: GitHub
- URL: https://github.com/zidoro/pomatez
- Owner: zidoro
- License: mit
- Created: 2019-09-04T07:07:53.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-09-20T02:21:51.000Z (3 months ago)
- Last Synced: 2024-10-29T15:10:01.743Z (about 1 month ago)
- 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
- Language: TypeScript
- Homepage: https://zidoro.github.io/pomatez/
- Size: 52.8 MB
- Stars: 4,042
- Watchers: 37
- Forks: 168
- Open Issues: 155
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome - zidoro/pomatez - Stay Focused. Take a Break. (TypeScript)
- awesome-repositories - zidoro/pomatez - Stay Focused. Take a Break. (TypeScript)
README
Pomatez
Stay Focused. Take a Break.
Features
.
Discord
.
Development
.
Installation
.
Privacy
.
License
## :sparkles: Features
- **Customizable rules** - it allows you to modify the default Pomodoro configuration based on your personal preferences.
- **Built-in task list** - it allows you to create a simple list of todos and mark the items done when it's done.
- **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.
- **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;
- _None_ - no notification will be shown. `default`
- _Normal_ - will show notification in every break.
- _Extra_ - will show notification 60 seconds before the break starts, and 30s before the break ends, and the actual break starts.
- **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.
- **Keyboard shortcuts** - might be helpful for you depending on your use case but currently, these keyboard shortcuts are not yet customizable.
- **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.
- **Always on top** - once enabled, the app will always be on top of other apps running on your Operating System.
- **Minimize to tray** - once enabled, the minimize action will not minimize the app. Instead, it will be hidden and sent to the tray.
- **Close to tray** - once enabled, the close action will not quit the app. Instead, it will be hidden and sent to the tray.
- **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.
- **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.
- **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.
- **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.
- **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.
- **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.
- **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.
- **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.
## :zap: Quick Setup
### :page_with_curl: Prerequisites
1. 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.
1. For Mac
```bash
brew install node
```
2. For Windows
```bash
choco install nodejs
```
3. For Linux
```bash
sudo apt install nodejs
```
4. Using [Node Version Manager](https://github.com/nvm-sh/nvm) (Recommended)
```bash
# Inside the project directory
nvm install && nvm use
```
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).
Or you can download it from [here](https://nodejs.org/en/download/).
2. 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.
1. For Mac
```bash
brew install yarn
```
2. For Windows
```bash
choco install yarn
```
3. For Linux
```bash
sudo apt install yarn
```
4. Using npm
```bash
npm install -g yarn
```
### :package: Installation
1. Install all app dependencies.
```sh
yarn install
```
2. Start the development.
```sh
yarn dev:app
```
### 🛠Building for Production
1. Build Windows installer.
```sh
yarn build:win
```
2. Build macOS installer.
```sh
yarn build:mac
```
3. Build Linux installer.
```sh
yarn build:linux
```
4. Build macOS, Windows and Linux installer at once.
```sh
yarn build:mwl
```
## :pencil: Pre-Commit
If 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).
Once that is installed just running `pre-commit` should automatically fix the files.
## :computer: Installation
Available for Windows, macOS, and Linux.
Download 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/) .
**For Linux users:**
> If you want to be always updated with the latest release, recommended way to install it is via Snap Store.
[](https://snapcraft.io/pomatez)
Please consider starring this project to show your :blue_heart: and support. Thank you so much :bowing_man:
## :newspaper: License
MIT © [Roldan Montilla Jr](https://github.com/roldanjr)