Private, fast, and honest web browser - now on Flatpak
Find a file
2026-05-21 05:59:26 +00:00
.github ci: display gh-actions bot username as helium-bot 2026-05-20 23:35:34 +02:00
icons icons: update assets with new branding 2026-03-03 10:56:50 +01:00
.gitignore feat: replace remote with bundle building 2026-02-17 09:19:01 +01:00
fetch.config.yml config: enable prerelease versions 2026-03-11 08:40:13 +01:00
grab_latest.sh Make sure we don't package Widevine with the Flatpak, the user is responsible for that 2026-05-12 02:58:58 +02:00
helium.flatpakrepo Add flatpakrepo file 2025-11-10 09:33:33 +01:00
helium.sh Make sure we don't package Widevine with the Flatpak, the user is responsible for that 2026-05-12 02:58:58 +02:00
LICENSE Initial commit 2025-11-08 18:37:14 +01:00
LICENSE.ungoogled_chromium license: separate helium & ungoogled licenses 2026-01-11 23:28:21 +01:00
net.imput.helium.desktop chore: add arch-specific instructions 2026-02-21 14:51:48 +01:00
net.imput.helium.metainfo.xml update: helium 0.12.4.1 2026-05-20 21:01:18 +00:00
net.imput.helium.yml Merge pull request 'main' (#2) from BlossomMirrors/helium-flatpak:main into main 2026-05-21 05:59:26 +00:00
README.md readme: clarify sandboxing details 2026-03-27 15:59:10 +01:00
version.txt update: helium 0.12.4.1 2026-05-20 21:01:18 +00:00

Helium Flatpak

This repository contains the Flatpak manifest for Helium, a private, fast, and honest web browser based on Ungoogled Chromium.

It wraps the official prebuilt binaries from the Helium Linux project into a partially sandboxed Flatpak environment, ensuring it runs consistently across different Linux distributions.
Full sandbox protection is currently not supported.


The easiest way to install Helium is using the standalone bundle. This bypasses the need for manual repositories and works on any system with Flatpak installed.

  1. Download the latest .flatpak bundle from the Releases Page.

  2. Install it via the command line, in the directory where you downloaded the file:

    flatpak install ./helium-[VERSION]-[ARCH].flatpak
    

    Note: on some distributions, you can simply double-click the downloaded file to install it via your Software Center.


Building from Source

If you want to build the package yourself or contribute to the manifest, follow these steps.

Prerequisites

Ensure you have flatpak and flatpak-builder installed. You also need the Flathub repository enabled to download the Freedesktop SDK/Runtime (version 24.08).

flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install org.freedesktop.Sdk/x86_64/24.08

Build & Install

Run the following command in the root of this repository. This will download the binary, build the sandbox, and install it to your user directory.

For x86_64 systems:

flatpak-builder --arch=x86_64 --user --install --force-clean build-dir net.imput.helium.yml

For ARM64 systems:

flatpak-builder --arch=aarch64 --user --install --force-clean build-dir net.imput.helium.yml

Note: to install for all users, use sudo and replace '--user' with '--system'.


Running the App

Once installed (via bundle or local build), you can launch Helium from your application menu or via the terminal:

flatpak run net.imput.helium

Uninstallation

To remove Helium and its data:

flatpak uninstall net.imput.helium
# Optional: Remove app data
rm -rf ~/.var/app/net.imput.helium

Disclaimer: This is an unofficial packaging project. For issues related to the browser itself, please refer to the upstream repository. For packaging issues, feel free to open an issue here.