⚠️ We’re looking for package maintainers to publish and maintain Pomolin across platforms/repositories (Nix, Debian, Arch/AUR, Fedora, Guix, etc.). If you can help, please open an issue; maintainers will be credited.

• Smooth Animations: The timer digits animate smoothly, offering a dynamic and visually pleasing experience.
• Routine Management: Switch between Pomodoro (25 min), Short Break (5 min), and Long Break (20 min) routines.
• Custom Work/Break Durations: Change the working or break durations in the settings menu.
• Cross-Platform: Native installers are provided for Windows, macOS, and Linux on both x64 and arm64 architectures.
• Pastel Color Palette: UI uses Catppuccin Mocha/Latte Color Palette as the default dark/light theme.

• Download the latest version from the official website.
• Get it from Itch.io.
• You can download the latest version of Pomolin from the Latest Release page.

1. Download the .msi or .exe file.

2. Run the installer and follow the on-screen instructions.

   NOTE:

   Browsers may say that the files can be harmful, you can bypass that message and continue download. Windows Defender will also try to stop you from running the installer, click on more options and then click run anyway.

1. Download the .dmg or .pkg file from Latest Release.

2. Open the .dmg file and drag the Pomolin.app to your Applications folder.

   NOTE:

   For macOS, it will not allow you to run the .pkg or the app installed using .dmg, to do so you will have to go to privacy and security in system settings, and then allow the execution of the app.

• Get the app from FlatHub:

  

• Get the .deb files for Debian and Ubuntu from Latest Release.

• Get AppImage files for respective hardware from Latest Release.

• Get Flatpak files for respective hardware from Latest Release.

  NOTE:

  • Install AppImage using AppImageLauncher/Gear Lever or equivalent. You can run the AppImage just by double-clicking on it too, no need to install it.
  • Flatpaks and AppImages are the preferred ways to run the app on Linux-based distributions.

1. Download the .jar file for your OS and CPU.

2. Run it using JRE/JDK 24:

   java -jar pomolin-macos-arm64-1.1.7-release.jar 

   NOTE: Make sure that you use java24 to run the jars. (Java21 on Windows Arm64). Preferably use Temurin or ZULU JRE/JDK.

To build Pomolin from the source code, you'll need to have JDK 21 or later installed.

1. Clone the repository:

   git clone [https://github.com/RedddFoxxyy/pomolin.git](https://github.com/RedddFoxxyy/pomolin.git)
   cd pomolin

2. Build the application using Gradle:

   • On Linux:

     ./gradlew packageReleaseDeb

   • On macOS:

     ./gradlew packageReleaseDmg

   • On Windows:

     .\gradlew.bat packageReleaseMsi

3. The compiled application will be available in the composeApp/build/compose/binaries/ directory.

This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.

Contributions made by all contributors are licensed strictly under GNU AGPL v3.0 only.

    Copyright (C) 2025  RedddFoxxyy(Suyog Tandel)

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Affero General Public License as
    published by the Free Software Foundation, either version 3 of the
    License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU Affero General Public License for more details.

    You should have received a copy of the GNU Affero General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.

The following directories contain artwork (app icons, logos, images, etc.) that are licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License (CC BY-NC-ND 4.0). For full details, refer to the LICENSE.md file located in each such directory:

• gitAssets/
• composeApp/src/desktopMain/composeResources/drawable/
• packaging/flatpak/

@RedddFoxxyy