Note

The official source code and active development for this project is hosted on Codeberg.

If you are viewing this repository on GitHub or another mirror, please note that Issues and Pull Requests are not monitored here.

👉 Join us at the Official Home: https://codeberg.org/lockedmutex/samaya

Samaya

A simple, elegant, minimalist Pomodoro timer for your desktop. Designed to help you stay focused and productive, it offers a clean, distraction-free interface to manage work and break intervals with ease.

Samaya means time in Hindi, written as समय.

Features

• Light Weight: The size of the app is only around 55KB and around 111KB including all the data and assets!
• 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.
• Skip Sessions: Skip the current session and start the next one.
• Timer Notifications: Get notified (using sound) when the timer ends.

Download & Installation

• Get the app from FlatHub:

  

• Flatpak builds for linux are available in latest release.

• To install the application from source:

  git clone -b release --single-branch https://codeberg.org/lockedmutex/samaya.git
  cd samaya
  meson setup build_release --buildtype=release -Dprefix=$HOME/.local
  meson compile -C build_release
  meson install -C build_release
  cd ..
  rm -rf samaya
  

• For other operating systems, the app can only be compiled and installed manually from source (and might fail because samaya depends heavily on glib, libcanberra and gsound which are linux only libs).

Building from Source

Software Dependencies Required:

• GCC14 or later / Clang 19 or later
• Meson (install using pip for latest version)
• Ninja
• CMake

Library Dependencies Required:

Steps to build:

1. Clone the repository:

   git clone https://codeberg.org/lockedmutex/samaya.git
   cd samaya
   

2. Build the application using Meson:

   meson setup builddir --buildtype=release
   meson compile -C builddir
   ./builddir/src/samaya
   

3. Install the application:

   meson install -C builddir
   

For Contributors:

• The project follows a mix of C naming conventions from LLVM, GNOME and/or GNU style C code, check .clang-tidy for more details.
• Compile and run the code on GNOME Builder using io.github.redddfoxxyy.samaya.json build configuration.
• Contributers using Zed or VSCode can directly run tasks to build and run the code (assuming all the required dependencies are installed).
• Need help with translating the app.

For Translators:

To translate Samaya, you can use Codeberg Translate(Weblate). This is the current translation status:

Code of Conduct

This project adheres to the GNOME Code of Conduct. By participating through any means, including PRs, Issues or Discussions, you are expected to uphold this code.

License

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  lockedmutex(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/>.

Maintainers

@lockedmutex