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)
  • Downloads Linux binaries
• Releasing the project
• TODO
• 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

Downloads 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

• Pico/Nano/Normal UI
• Tons of options (run script on pomodoro end, notification sound on/off, ...)
• Release Windows, macOS, Android, IOS versions

Credits

• Icon made by Freepik from Flaticon
• Screenshot pimped with PrettySnap
• Notification sound from Zedge