fynodoro

README

Fynodoro is a tiny and cute Pomodoro Widget

Table of contents

• Screenshots
  • Timer
  • Settings
• Features
• Changelog
• Configuration
  • Notification sound
• Install
  • Install Ubuntu/Debian (.deb)
  • Install Fedora/Redhat (.rpm)
  • Download Linux binaries
• Releasing the project
• TODO & IDEAS
• Credits

Screenshots

Timer

Settings

Features

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

Changelog

See the Releases section on GitHub.

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.

Notification sound

The notification sound is stored in: /usr/share/fynodoro/notification.mp3.
You can override it if you wish with another mp3 file.

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
# Publish Release draft: https://github.com/tomsquest/fynodoro/releases

TODO & IDEAS

• Make the timer clickable (start/stop)
• Display the type of Pomodoro: Work/Short/Long
• Display the time left in the Tray (see Fomato
• Resizable UI (scale timer and buttons with the window)
• Pico/Nano/Normal UI presets
• option for Dark/Light mode (what about Fyne global preferences?)
• option to disable notification popup
• option to change notification script
• Keyboard shortcuts
• 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