v1.0.2

v1.0.2 (26 September 2025)

This version addresses a couple of new bugs, one of which is quite annoying:

• Can't void a pomodoro or record an interruption in non-latest backlogs (#199, #195).
• An occasional exception when waking up from sleep (#197).

Release Candidate (BETA)

This is a candidate for the upcoming Flowkeeper release. It is updated automatically on each push to main. Expect bugs.

v1.0.1

v1.0.1 (30 August 2025)

This version addresses all known bugs that we had in GitHub:

• Miscellaneous font issues (#136).
• Backlogs toggle icon doesn't change its color on theme change (#138).
• Voiding a pomodoro that has already finished (#149).
• Focus mode lost window title on Wayland (#152).
• Timezone not handled in task tooltips (#156).
• Tutorial bubbles don't follow underlying windows (#162).
• Pin/unpin icon is visible on Wayland (#185).
• Unhandled TypeError while clicking "Surprise me" button repeatedly (#188).
• "Long break" keeps on triggering while it is deactivated in the configuration (#192).

Also, Windows binaries are now compiled using Clang to reduce antivirus false positives.

v1.0.0

v1.0.0 (14 June 2025)

This version brings Flowkeeper even closer to the original Pomodoro Technique definition from Francesco Cirillo's book.
Pomodoro interruptions are now handled as the book prescribes, and we introduced support for long breaks. One major
deviation from the Technique in this version is the ability to track unfocused time. As usual there's a bunch of
miscellaneous quality-of-life improvements, bugfixes and better support for Linux.

New features:

• Tracking unfocused time -- try to start a work item with no pomodoros (#94, #98).
• Long breaks and working in series, see Settings > Series and breaks (#53).
• Dragging work items between backlogs (#60).
• Recording interruptions (#75).
• Voided pomodoros are displayed as ticks, and completed ones are crossed out to better match the Book (#41, #92).
• Import from CSV and GitHub, try Ctrl+I (#125).
• Hovering over pomodoros displays a detailed log of your work (#93).
• "Contact us" submenu to facilitate feedback collection (#111).
• Flowkeeper window now hides automatically on auto-start (#102).
• New font selector for macOS, which supports Apple system font (#113).
• Resting music starts playing from the right position if we restart Flowkeeper.

Technical improvements:

• Standard data and log directories on Linux, macOS and Windows (#65).
• Three new ways to get Flowkeeper:
• Install it from Flathub (#63),
• Install from OBS for openSUSE Tumbleweed (#127),
• Download a portable AppImage from flowkeeper.org or GitHub Releases.
• Flowkeeper now supports Linux on arm64 / aarch64.
• Added support for Qt 6.8.x.
• A preview of Flowkeeper CLI is now available in the sources (#46).
• Ignoring own modifications when "watch changes" is enabled (#130).
• Improved technical documentation (#80, #87).
• Complete drag & drop rewrite to accommodate moving work items between backlogs.
• Flowkeeper binaries are now built using Nuitka in addition to PyInstaller (#114).
• Madelene music composition changed its format from mp3 to m4a/aac.
• Removed support for Ubuntu 20.04, as GitHub Actions deprecated it.

Bug fixes:

• Selecting directory as log file (#108).
• Window icon on Wayland (#110).
• Line breaks in work items and backlogs (#132).
• Changing audio devices while Flowkeeper is running (#120).

v0.9.1

v0.9.1 (15 January 2025)

This is a bugfix release, it has no new features.

• [Bugfix] Main window doesn't restore correctly on Hyprland (#48).
• [Bugfix] Unhandled SystemError if Flowkeeper is upgraded while a pomodoro is running (#62).
• [Bugfix] Broken fonts / squares instead of characters on Ubuntu 23.10 (#68).
• [Bugfix] "Unhandled JSONDecodeError" behind the proxy (#69, #73).
• [Bugfix] Flowkeeper crashes when you select a directory as a data file (#70).
• [Bugfix] Error when trying to start another pomodoro while the timer is running (#72, #74).
• [Bugfix] On Windows, the main window close button is disabled (#77).
• [Bugfix] Flowkeeper doesn't switch to focus mode after one completed pomodoro (#79).
• [Bugfix] Unhandled AttributeError when computer wakes up from sleep while playing audio (#81).
• [Bugfix] There's no sound until you change Audio settings once (#85).
• [Bugfix] Able to click "next pomodoro" after marking workitem complete (#88).
• [Technical] Enhanced bug reporting - GitHub issues now include info about versions.
• [Technical] New command-line flag: --debug, enables debug logs for this session.
• [Technical] System proxy settings are applied automatically.
• [Technical] Using embedded Noto Sans font by default, see Settings > Fonts.

v0.9.0

v0.9.0 (30 December 2024)

• You can now drag backlogs and work items to reorder them. Backlogs are not reordered automatically anymore.
• Unplanned work items are now highlighted with asterisk (*).
• You can now choose between two timer widgets -- "Classic" and "Minimalistic".
• Quick configuration wizard when you open Flowkeeper for the first time.
• Moved "Hide completed items" to the toolbar (#42).
• In "minimalistic" mode all focus mode actions are under the "stopwatch" menu.
• You can now configure Flowkeeper to execute programs on different events, see Settings > Integration (#40).
• All buttons and icons now have tooltips with shortcuts in them (#43, #52).
• Journaling-friendly Work Summary (F3) -- more output formats and enhanced usability (#45, #49).
• New setting: General > Single Flowkeeper instance (#50).
• Miscellaneous UI improvements, notably new tray icon visualization (#44, #51, #39).
• You can now enable main menu in Settings > Appearance.
• [Bugfix] Couldn't open Settings when there's no audio devices (#38).

v0.8.1

v0.8.1 (13 November 2024)

• [Bugfix] Fixed a bug in tutorial step 8.

v0.8.0

v0.8.0 (4 November 2024)

• You can now use #tags in work items. You can turn it off in Settings > General.
• When #tags are enabled, work item text wraps if it doesn't fit on one line. This is the default behavior.
• Embedded resting music - "Madelene" by Lobo Loco, with kind permission from its author (CC-BY-NC-ND).
• Selectable audio output in Settings > Audio.
• [Technical] Flowkeeper displays window title in the focus mode on Wayland automatically.
• [Technical] StartWork strategy now also carries planned rest duration.
• [Technical] Smart import now preserves timestamps and history.
• [Technical] We can now import stuff which happened in the past.
• [Bugfix] Fixed "user already exists" import error.
• [Bugfix] Fixed incorrect pomodoro states after import.
• [Bugfix] Fixed incorrect timestamps in smart import.
• [Bugfix] Fixed incorrect work / rest durations in smart import.

v0.7.1

v0.7.1 (13 September 2024)

• [Bugfix] Fixed import/export wizard look & feel on Windows 11 with Qt 6.7.x.
• [Bugfix] Fixed "No QtMultimedia backends found" issue on macOS.

v0.7.0

v0.7.0 (10 September 2024)

• Disabled data sync and e2e encryption features.
• Removed public references to any semi-implemented features.
• Documented the full manual UAT test suite and executed it.
• The hole in the timer widget now displays correctly.
• New "Compress" action in the File source settings (click it for details).
• New "Detect automatically (Default)" theme.
• Added "New Backlog From Incomplete" action to speed up planning.
• New "Work Summary" feature for making human-readable reports like time sheets.
• Special appearance defaults for Gnome to match its quirks.
• Minor improvements in Statistics (different bar colors, better theming)
• [Bugfix] Fixed the 00:00 bug when the user opened the client right when the work ends.
• [Bugfix] Fixed a rare bug when we tried to read a file which was written at the same time.
• [Bugfix] Fixed an "Invalid key" bug in Import.
• [Bugfix] Fixed a bug where workitem actions' visibility was wrong after external changes.
• [Technical] Removed CompletePomodoro and StartRest strategies.
• [Technical] Removed "Auto-seal items after" setting.
• [Technical] Split the README.md into several files.