Skip to content

fix(flatpak): enable tray registration and harden documentation#49

Merged
TimInTech merged 4 commits into
mainfrom
docs/flatpak-build-notes
Jul 12, 2026
Merged

fix(flatpak): enable tray registration and harden documentation#49
TimInTech merged 4 commits into
mainfrom
docs/flatpak-build-notes

Conversation

@TimInTech

@TimInTech TimInTech commented Jul 6, 2026

Copy link
Copy Markdown
Owner

Summary

  • Refresh README.md, README.de.md, and the Flatpak build notes after the successfully built local Flatpak MVP.
  • Allow the sandboxed application to register its tray icon through the narrowly scoped permission:
    --talk-name=org.kde.StatusNotifierWatcher.
  • Fix the documentation examples that triggered the repository secret-hygiene scan.
  • Keep the Flatpak MVP explicitly experimental: no Flathub submission, release, tag, version bump, desktop file, AppStream metadata, or icon packaging.

Tray registration fix

Without access to org.kde.StatusNotifierWatcher, the Flatpak process started and remained alive, but no tray icon or reachable window appeared. Blitztext is tray-oriented, so this made the sandboxed application effectively inaccessible.

The manifest now grants only:

--talk-name=org.kde.StatusNotifierWatcher

No broad session-bus permission was added.

Real verification after rebuild and installation:

  • exactly one running Blitztext Flatpak instance
  • StatusNotifierItem registered with title Blitztext
  • no org.freedesktop.DBus.Error.ServiceUnknown
  • successful shutdown with no remaining Flatpak instance
  • existing native systemd-user instance remained untouched

Documentation and CI fix

The secret-hygiene workflow rejected literal API-key examples in README.md and README.de.md. These examples were replaced with generic descriptions.

The workflow and .github/secret-scan-patterns.txt were not changed or weakened.

Verification

  • python3 -m compileall app tests

  • QT_QPA_PLATFORM=offscreen WHISPER_GUI_TESTS=1 python -m pytest -q

    • 494 passed
  • bash -n scripts/install.sh

  • bash -n scripts/verify.sh

  • git diff --check

  • repository secret scan using .github/secret-scan-patterns.txt

  • real flatpak-builder --user --install build

  • real Flatpak tray and D-Bus smoke test

Scope exclusions

  • no application-code changes
  • no installer or service changes
  • no desktop file, AppStream metadata, or icon
  • no Flathub submission
  • no version bump, tag, or release
  • no Vault or roadmap changes

Rollback

After a squash merge:

git revert <squash-commit>

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

Real flatpak-builder --install test run showed the app starting and
staying alive but never becoming reachable: no tray icon, no window.
Blitztext starts exclusively as a tray icon (blitztext_linux.py
setup_tray), and without --talk-name=org.kde.StatusNotifierWatcher the
sandboxed Qt/KDE tray backend can't register the StatusNotifierItem
(D-Bus ServiceUnknown), leaving no way to open the GUI at all.

Verified via busctl that the tray item registers correctly after the
fix. Documented root cause and verification in the Flatpak README.
@TimInTech TimInTech changed the title docs: refresh README and Flatpak build notes fix(flatpak): enable tray registration and harden documentation Jul 12, 2026
@TimInTech
TimInTech merged commit c30d0d0 into main Jul 12, 2026
7 checks passed
@TimInTech
TimInTech deleted the docs/flatpak-build-notes branch July 12, 2026 20:35
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.

1 participant