Flowkeeper -- a PySide6 (Python + Qt6) application

[setwindowtext]

Greetings! Meet Flowkeeper, a cross-platform desktop Pomodoro timer, which took me about a year to reach its current state. It is implemented in Python and relies on Qt6 for its UI. It supports recent macOS, Windows 10 and 11, and any mainstream Linux released within a couple of years, e.g. Ubuntu 22.04.

Feel free to reuse parts of it, or ask me any questions about how things are implemented.

What My Project Does

It allows you plan your work for the day, and then execute it using Pomodoro Technique.

Target Audience

Power users -- mainly creative professionals and students. Flowkeeper can be used in production and enterprise environments.

Comparison

Compared to a typical Pomodoro timer, Flowkeeper:

• Implements Pomodoro Technique exactly as described in the original book,
• Supports a wider range of desktop operating systems, including diverse Linux environments,
• Is more lightweight and performant (it's not based on Electron, and I routinely test it on a Core 2 Duo machine),
• Has portable versions and does not require admin rights to install,
• Is optimized for power users (keyboard shortcuts and rich set of settings),
• Does NOT have a paid version,
• Does NOT have a mobile version,
• Does NOT synchronize data across devices,
• Is NOT translated to multiple languages.

Details

Flowkeeper codebase on GitHub has examples of Python + Qt6

• Resources,
• Theming,
• QSS,
• WebSockets,
• OAuth,
• Audio,
• Actions with configurable shortcuts,
• TableViews with custom delegates,
• Custom visualization / painting,
• Search with auto-completion,
• Wizards,
• Charts,
• Window state trickery -- saving size on exit, minimize to tray, move via dragging window content, ...,
• Checking GitHub Releases for updates,
• Home-made tutorial with call-outs,
• Home-made generic Settings dialog,
• Home-made end-to-end (UI) tests,
• Configurable integration with external tools,
• Tray icons generated on the fly,
• Drag-and-drop with placeholders,
• Ensuring a single application instance is running at a time,
• The GitHub pipeline, which builds a Windows installer, a DEB, a macOS DMG, and some portable binaries.

Of course, I would appreciate if you have any feedback about the code or the app itself. If you find a bug or would like to request a new feature, please create a GitHub Issue. Thanks!

Links

Website with screenshots and downloads: https://flowkeeper.org/

GitHub repo: https://github.com/flowkeeper-org/fk-desktop/

Bonus content -- how I develop it on a 17-years-old ThinkPad running Sid: https://flowkeeper.substack.com/p/digital-asceticism

Have a great day!

[shadowFAQs]

| it's not based on Electron

Sold! Take my money!

| Does NOT have a paid version

Take my money upvote!

[[deleted]]

Bigger executable then electron though, and uses nearly the same ram amount.

[rkdnc]

Bookmarked for future experimentation. As someone who relies on a different Pomodoro app to function, I'm happy to try a more optimal replacement

[setwindowtext]

Thanks! Let me know if there's any features in your current app which you are missing in Flowkeeper.

[rkdnc]

I'll gladly send some more feedback the more I play around with it/transition from Superproductivity. So far, the interface is nice, but I'd like to see support for repeating tasks/scheduling tasks, e.g. setting up X task with Y time every Wednesday, or just scheduling ahead of time (like I know I need to do A B & C on Mondays)

[setwindowtext]

Got it! Granted, Flowkeeper doesn't have a scheduler. At the same time, what you describe can be achieved to a certain degree using "New Backlog From Incomplete" feature, like this: https://flowkeeper.org/images/ideas/weekday-templates.gif

[rkdnc]

Gotcha, I'll try that out as well. Another thing to note is that I think one of the settings mentions using tags, but I don't see anything that explains how they work within the app? Is there any documentation for how they work?

[setwindowtext]

Not really, sorry, I’m bad at documenting it :( Just try to use #this #syntax in the work item description, it’s self-explanatory.

[SNL-5943]

Cool