This Flatpak package downloads and runs the official eTax Zug app in a sandboxed environment — no more tax-ing installations!

This repository packages the official eTax Zug Java desktop application as a Flatpak for easy installation and sandboxing on Linux systems. Filing your taxes has never been so… contained! 🥳

• Downloads the official installer from the canton Zug website (no shady business—just Swiss precision!)
• Runs the original installer (no funny business, except in this README)
• Sandboxed and isolated from the rest of your system (your other apps won't get "taxed")

Install Flatpak (if not already installed)

sudo apt install flatpak # Debian/Ubuntu
# or
sudo dnf install flatpak # Fedora

1. Add the Flatpak repo:

   flatpak remote-add --user --if-not-exists etaxzug https://alexanderadam.github.io/etax_flatpak/repo/
   flatpak remote-modify --no-gpg-verify etaxzug

2. (Optional — also I still have to do this first 🤣) Import the GPG key:

   Download the key:

   wget https://alexanderadam.github.io/etax_flatpak/repo/gpgkey
   flatpak remote-modify --gpg-import=repo/gpgkey etaxzug
   

3. Install the app:

   flatpak install --user etaxzug ch.zg.etax

4. Run eTax Zug:

   flatpak run ch.zg.etax

• Repo URL: https://alexanderadam.github.io/etax_flatpak/repo/
• GPG Key: See above or .flatpakrepo file.

git clone https://github.com/alexanderadam/etax_flatpak.git
cd etax_flatpak

flatpak-builder --user --install --force-clean build-dir flatpak/ch.zg.etax.yaml

flatpak run ch.zg.etax

• The Flatpak manifest uses extra-data to download the official eTax Zug installer zip at install time.
• A post-install script extracts the shell installer and installs the Java app and desktop file inside the Flatpak.

New year, new taxes! To update for a new tax year, just update the Flatpak manifest URL, SHA256, and filenames to match the new official eTax Zug release. See the Flatpak manifest and launcher script for details. For development and contribution, see CONTRIBUTING.md. (Don’t worry, it’s less work than your tax return!)

If you encounter issues, please open an issue on GitHub. For advanced troubleshooting, see flatpak/README.md.

• flatpak/ — Contains all Flatpak-specific files:
  • ch.zg.etax.yaml — Main Flatpak manifest
  • ch.zg.etax.post-install.sh — Post-install script for extracting the app after download.
  • etaxzug.sh — Launcher script for the eTax Zug app inside the Flatpak sandbox.
  • README.md — Flatpak usage and packaging notes.
• repo/ — Flatpak repository. This is what gets published to GitHub Pages for user installation.
  • config, summary, objects/, etc. — Standard OSTree repo structure.
• .github/workflows/ — GitHub Actions CI/CD workflows for building and publishing the Flatpak repo.
  • flatpak.yml — Main workflow for build and deploy.
• .flatpakrepo — Metadata file for users to add the repo to Flatpak.
• build.sh — Local build and export script
• CONTRIBUTING.md — Contribution guidelines

Other files and directories may be present for specific releases, tests, or local development. See the README for user instructions and this file for advanced packaging details.

This repo only packages the official eTax Zug app. All rights to the app remain with the canton Zug.