Fynodoro is a tiny and cute Pomodoro Widget

Table of contents

• Screenshots
• Features
• Changelog
• Usage
• Configuration
  • Start minimized
  • Notification popup
  • Notification script
• Install
  • Install Ubuntu/Debian (.deb)
  • Install Fedora/Redhat (.rpm)
  • Download Linux binaries
• Releasing the project
• TODO & IDEAS
• Credits

Screenshots

Features

• ⏲️ Pomodoro Timer ✨
• 🗒️ Configurable: work duration, short break/long break, work rounds 🖊️
• 🏆 Small download size
• 💼 Releases for Ubuntu/Debian, Fedora/Redhat, and as a linux binary

Changelog

See the Releases section on GitHub.

Usage

A .desktop file is installed for you, so you can start Fynodoro from your application menu.

You can also start it from the command line:

fynodoro              # Start normally
fynodoro --minimized  # Start minimized to system tray

Configuration

The Pomodoro technique defaults to 4 work rounds of 25 minutes, with a 5 minutes pause ("short break") in-between and a final 15 minutes pause (the "long" break), for a total of 2 hours (4x25m Work + 3x5m Short breaks + 1x15m Long break).

You can configure:

• the duration in minutes of the Work period (default: 25 minutes)
• the duration in minutes of the Short breaks (default: 5 minutes)
• the duration in minutes of the Long breaks (default: 15 minutes)
• the number of Work rounds before a long break (default: 4 rounds)

You can disable Long breaks by setting the duration of Long breaks to 0 or the number of work rounds to 0. This will make the timer do a Work period, then a Short break, and so-on, and never do Long break.

You can disable Short breaks by setting the duration of Short breaks to 0. This will make the timer do a Work period, then a Long break, and so-on, and never do Short break.

Tips: you can disable both Short and Long breaks by setting them to 0. The timer will then act as a ticker, notifying you after each Work period.

Start minimized

You can start minimized to the system tray by enabling the option in Settings, or by using the --minimized command-line flag.

Notification popup

You can disable the notification popup by unchecking the option in Settings. This is useful if you only want the notification script to run without a popup.

Notification script

The notification script is executed when a pomodoro ends. By default, it is located at: /usr/share/fynodoro/notify.sh.

You can customize the notification script path in Settings, or leave it empty to disable script execution entirely.

The default script plays a sound file located at: /usr/share/fynodoro/notification.mp3. You can replace it with another mp3 file if you wish to change the notification sound.

Install

Install Ubuntu/Debian (.deb)

Latest:

Add the repository and install Fynodoro:

curl -1sLf 'https://dl.cloudsmith.io/public/tomsquest/fynodoro/setup.deb.sh' | sudo -E bash
sudo apt install fynodoro 

Complete instructions at CloudSmith.io

Install Fedora/Redhat (.rpm)

Latest:

Add the repository and install Fynodoro:

curl -1sLf 'https://dl.cloudsmith.io/public/tomsquest/fynodoro/setup.rpm.sh' | sudo -E bash
# Choose between:
sudo dnf install fynodoro
sudo yum install fynodoro
sudo microdnf install fynodoro
sudo zypper install fynodoro

Complete instructions at CloudSmith.io

Download Linux binaries

Latest:

See the Releases section for downloads.

Releasing the project

Push a new tag from a clean master:

git checkout master && git pull
if ! [ -z "$(git status --untracked-files=no --porcelain)" ]; then 
  echo "Warning: there are some local changes"
fi
git fetch --all --tags
TAG=v1.0.0 && git tag $TAG && git push origin $TAG
# Check Release Build https://github.com/tomsquest/fynodoro/actions/workflows/release.yaml
# Check Release Note  https://github.com/tomsquest/fynodoro/releases

TODO & IDEAS

• Display the type of Pomodoro: Work/Short/Long
• Release Windows, macOS, Android, IOS versions

Credits

• Fynodoro is built in Go, using the awesome Fyne toolkit for the UI
• CloudSmith.io for hosting the packages
• Go Releaser for the release automation
• Icon made by Freepik from Flaticon
• Screenshot pimped with PrettySnap
• Notification sound from Zedge