Skip to content

feat: add Flatpak packaging support#548

Open
GabeDuarteM wants to merge 19 commits intocjpais:mainfrom
GabeDuarteM:feature/add-flatpak-support
Open

feat: add Flatpak packaging support#548
GabeDuarteM wants to merge 19 commits intocjpais:mainfrom
GabeDuarteM:feature/add-flatpak-support

Conversation

@GabeDuarteM
Copy link
Copy Markdown
Contributor

@GabeDuarteM GabeDuarteM commented Jan 7, 2026

Before Submitting This PR

Please confirm you have done the following:

Human Written Description

Added Flatpak support and CI infrastructure to build it, implement an autostart module to add support for flatpak (The exec of the .desktop files are slightly different from the existing ones, so we needed to adapt), implemented some checks to make sure the tray icons also work on flatpak, enabled enigo only when we're in x11 (otherwise the app was failing to start on wayland's flatpak).
Also had to change the CSS for the close icon on "visual feedback overlay", since on flatpak occasionally it would spawn two close icons, one where it should be, and another one outside the pill. I couldn't figure out why, and it wasn't consistently happening too, so I hid the render of whatever is outside the pill. My theory is that it may be related to WEBKIT_DISABLE_DMABUF_RENDERER=1, but without it the whole app doesn't render at all, just a black/white screen (depending on your dark settings config)

We still need to do some work on the manifest to add some screenshots and maybe wire the changelog into it, then we can submit it to flathub

Related Issues/Discussions

Discussion: #254

Community Feedback

#254

Testing

  • Built the flatpak image and installed it
  • App's overall design looks identical to the AppImage's version
  • Shortcuts working properly through sigkill (can't test the other methods since they don't work on my distro)
  • Autostart, Start hidden, Overlay working properly
  • Unfortunately I couldn't test my changes on AppImage (can't build it on arch, not even on main), or deb/rpm/macos/windows (don't have those systems). Would be great if someone with those systems could also check if everything is still working fine, at least for deb/rpm/macos
  • Need to check if the CI is working fine

If you wanna help testing locally, you can run:

  • bun run tauri build --bundles deb
  • ./scripts/build-flatpak.sh
  • flatpak install --user handy_0.6.10_x86_64.flatpak
  • flatpak run com.pais.handy

Screenshots/Videos (if applicable)

2026-01-07.11-21-31.mp4

Loading
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants