Skip to content

pojntfx/sessions

Repository files navigation

Project icon

Sessions

Focus with timed work intervals.


Flatpak CI Go Version Go Reference Matrix Weblate translation status

Overview

Sessions is a simple visual timer application designed specifically for the pomodoro technique, helping you stay productive by breaking work into focused sessions with regular breaks.

It enables you to:

  • Start focused work sessions with customizable timer durations
  • Track your progress with a clean, distraction-free interface
  • Take regular breaks to maintain productivity

Installation

On Linux, Sessions is available on Flathub:

Download on Flathub

For other platforms, see contributing; development builds are also available on GitHub releases.

Tutorial

The pomodoro technique is a time management method that uses a timer to break work into intervals, traditionally 25 minutes in length, separated by short breaks. Here's how to use Sessions:

  1. Set your timer: Choose your work session duration (25 minutes is typical)
  2. Start working: Focus on a single task during the timer
  3. Take a break: When the timer ends, take a 5-minute break
  4. Repeat: After 4 sessions, take a longer 15-30 minute break

🚀 That's it! We hope Sessions helps you with your productivity.

Screenshots

Click on an image to see a larger version.

Setting up a new timer session Timer running during a work session

Acknowledgements

Contributing

To contribute, please use the GitHub flow and follow the GNOME Code of Conduct.

To build and start a development version of Sessions locally, run the following:

$ git clone https://github.com/pojntfx/sessions.git
$ cd sessions
$ go generate ./...
$ go run -ldflags="-X 'main.LocaleDir=${PWD}/po' -X 'main.SchemaDir=${PWD}/assets/resources'" .

You can also open the project in GNOME Builder and run it by clicking the play button in the header bar, or use Foundry directly:

$ foundry init
$ foundry run

If you want to reproduce the build from Flathub, you can use flatpak-builder directly:

$ flatpak run --command=flathub-build org.flatpak.Builder --install com.pojtinger.felicitas.Sessions.json
$ flatpak run --command=flatpak-builder-lint org.flatpak.Builder manifest com.pojtinger.felicitas.Sessions.json
$ flatpak run --command=flatpak-builder-lint org.flatpak.Builder repo repo
$ flatpak run com.pojtinger.felicitas.Sessions

To translate Sessions, you can use Weblate. This is the current translation status:

Weblate translation status graphs

License

Sessions (c) 2026 Felicitas Pojtinger and contributors

SPDX-License-Identifier: AGPL-3.0