Awesome
<p align="center"> <a href="https://zidoro.github.io/pomatez/"> <img src=".github/assets/logo.png" alt="Pomatez logo" width="56" height="56"> </a> </p> <h1 align="center">Pomatez</h1> <h3 align="center">Stay Focused. Take a Break.</h3> <p align="center"> <br> <a href="#sparkles-features">Features</a> . <a href="https://discord.gg/ZqPqN3hwcB" target="_blank">Discord</a> . <a href="#call_me_hand-development">Development</a> . <a href="#computer-installation">Installation</a> . <a href="#shield-privacy">Privacy</a> . <a href="#newspaper-license">License</a> <br> <br> </p> <p align="center"> <a href="https://snapcraft.io/pomatez"> <image src="https://snapcraft.io/pomatez/badge.svg" alt="Pomatez" /> </a> <image src="https://img.shields.io/github/downloads/zidoro/pomatez/total" alt="Github Downloads" /> <a href="https://github.com/zidoro/pomatez/releases/latest"> <image src="https://img.shields.io/github/v/release/zidoro/pomatez" alt="Latest Version" /> </a> <a href="https://github.com/zidoro/pomatez/blob/master/LICENSE"> <image src="https://img.shields.io/github/license/zidoro/pomatez" alt="License" /> </a> </p>: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.
- None - no notification will be shown.
-
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
-
You need to have
node
v18 andnpm
v8 installed on your machine. If you don't have it yet, you can install it by running the following command.-
For Mac
brew install node
-
For Windows
choco install nodejs
-
For Linux
sudo apt install nodejs
-
Using Node Version Manager (Recommended)
# 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.
Or you can download it from here.
-
-
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.-
For Mac
brew install yarn
-
For Windows
choco install yarn
-
For Linux
sudo apt install yarn
-
Using npm
npm install -g yarn
-
:package: Installation
-
Install all app dependencies.
yarn install
-
Start the development.
yarn dev:app
🛠Building for Production
-
Build Windows installer.
yarn build:win
-
Build macOS installer.
yarn build:mac
-
Build Linux installer.
yarn build:linux
-
Build macOS, Windows and Linux installer at once.
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.
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 or from the :point_right: Download Page .
For Linux users:
If you want to be always updated with the latest release, recommended way to install it is via Snap Store.
Please consider starring this project to show your :blue_heart: and support. Thank you so much :bowing_man:
:newspaper: License
MIT © Roldan Montilla Jr