From f068fd84d585090fce852df42dd185cd4ab824f8 Mon Sep 17 00:00:00 2001
From: UmutKzl <261115766+UmutKzl@users.noreply.github.com>
Date: Thu, 9 Jul 2026 17:20:16 +0300
Subject: [PATCH 1/8] feat(browsers): add helium-browser

helium browser is supported in AUR, dnf and apt.

if user is using arch linux (or arch based distro), script automatically downloads from AUR.

if user is using fedora (or fedora based distro), script adds a copr repo and installs helium

if user is using debian (or debian based distro), script adds helium repo and installs helium

for other distros there's no installation :(
---
 .../browsers/helium-browser.sh                | 35 +++++++++++++++++++
 core/tabs/applications-setup/tab_data.toml    |  6 ++++
 2 files changed, 41 insertions(+)
 create mode 100755 core/tabs/applications-setup/browsers/helium-browser.sh

diff --git a/core/tabs/applications-setup/browsers/helium-browser.sh b/core/tabs/applications-setup/browsers/helium-browser.sh
new file mode 100755
index 000000000..4b3d47539
--- /dev/null
+++ b/core/tabs/applications-setup/browsers/helium-browser.sh
@@ -0,0 +1,35 @@
+#!/bin/sh -e
+
+. ../../common-script.sh
+
+installHeliumBrowser() {
+    if ! command_exists Helium && ! command_exists helium; then
+        printf "%b\n" "${YELLOW}Installing Helium Browser...${RC}"
+        case "$PACKAGER" in
+        pacman)
+            "$AUR_HELPER" -S --needed --noconfirm helium-browser-bin
+            ;;
+        dnf)
+            "$ESCALATION_TOOL" "$PACKAGER" copr enable imput/helium
+            "$ESCALATION_TOOL" "$PACKAGER" install -y helium-bin
+            ;;
+        nala|apt-get)
+            "$ESCALATION_TOOL" "$PACKAGER" install -y curl
+            curl -fsSL https://raw.githubusercontent.com/imputnet/helium-linux/main/pubkey.asc | "$ESCALATION_TOOL" gpg --dearmor -o /usr/share/keyrings/helium.gpg
+            echo "deb [signed-by=/usr/share/keyrings/helium.gpg] https://pkg.helium.computer/deb stable main" | "$ESCALATION_TOOL" tee /etc/apt/sources.list.d/helium.list
+            "$ESCALATION_TOOL" "$PACKAGER" update
+            "$ESCALATION_TOOL" "$PACKAGER" install -y helium-bin
+        ;;
+        *)
+            printf "%b\n" "${RED}Helium doesn't support ${PACKAGER}${RC}"
+            ;;
+        esac
+    else
+        printf "%b\n" "${GREEN}Helium Browser is already installed.${RC}"
+    fi
+}
+
+checkEnv
+checkEscalationTool
+checkAURHelper
+installHeliumBrowser
diff --git a/core/tabs/applications-setup/tab_data.toml b/core/tabs/applications-setup/tab_data.toml
index 4afb9531b..43a6a2750 100644
--- a/core/tabs/applications-setup/tab_data.toml
+++ b/core/tabs/applications-setup/tab_data.toml
@@ -339,6 +339,12 @@ description = "Zen Browser is a privacy-focused web browser designed for enhance
 script = "browsers/zen-browser.sh"
 task_list = "I"
 
+[[data.entries]]
+name = "Helium Browser"
+description = "Helium Browser is a free, privacy-focused and open-source chromium-based browser designed for enhanced security and a seamless browsing experience."
+script = "browsers/helium-browser.sh"
+task_list = "I"
+
 [[data]]
 name = "Alacritty"
 description = "Alacritty is a modern terminal emulator that comes with sensible defaults, but allows for extensive configuration. By integrating with other applications, rather than reimplementing their functionality, it manages to provide a flexible set of features with high performance. The supported platforms currently consist of BSD, Linux, macOS and Windows. This command installs and configures alacritty terminal emulator."

From 777887d262d121deb28763d37f6224d45dd1dfc8 Mon Sep 17 00:00:00 2001
From: UmutKzl <kzzzl@proton.me>
Date: Sat, 11 Jul 2026 12:53:29 +0300
Subject: [PATCH 2/8] feat(browsers): add helium-browser

---
 .../browsers/helium-browser.sh                | 34 ++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/core/tabs/applications-setup/browsers/helium-browser.sh b/core/tabs/applications-setup/browsers/helium-browser.sh
index 4b3d47539..bf3093e01 100755
--- a/core/tabs/applications-setup/browsers/helium-browser.sh
+++ b/core/tabs/applications-setup/browsers/helium-browser.sh
@@ -27,9 +27,41 @@ installHeliumBrowser() {
     else
         printf "%b\n" "${GREEN}Helium Browser is already installed.${RC}"
     fi
+uninstallHeliumBrowser() {
+  if command_exists Helium && commands_exists helium; then
+    printf "%b\n" "${YELLOW}Removing Helium Browser...${RC}"
+    case "$PACKAGER" in
+    pacman)
+      "$ESCALATION_TOOL" "$PACKAGER" -R --noconfirm --needed helium-browser-bin
+      ;;
+    dnf)
+      "$ESCALATION_TOOL" "$PACKAGER" uninstall helium-bin
+      "$ESCALATION_TOOL" "$PACKAGER" copr disable imput/helium
+      ;;
+    nala | apt-get)
+      [[ -f "/usr/share/keyrings/helium.gpg" ]] && rm "/usr/share/keyrings/helium.gpg"
+      [[ -f "/etc/apt/sources.list.d/helium.list" ]] && rm "/etc/apt/sources.list.d/helium.list"
+      ;;
+    esac
+  else
+    printf "%b\n" "${GREEN}Helium Browser is not installed.${RC}"
+  fi
+}
+
+main() {
+  printf "%b\n" "${YELLOW}Do you want to Install or Uninstall Helium Browser?${RC}"
+  printf "%b\n" "1. ${YELLOW}Install Helium Browser${RC}"
+  printf "%b\n" "2. ${YELLOW}Uninstall Helium Browser${RC}"
+  printf "%b" "Enter your choice [1-2]: "
+  read -r CHOICE
+  case "$CHOICE" in
+  1) installHeliumBrowser ;;
+  2) uninstallHeliumBrowser ;;
+  *) printf "%b\n" "${RED}Invalid choice.${RC}" && exit 1 ;;
+  esac
 }
 
 checkEnv
 checkEscalationTool
 checkAURHelper
-installHeliumBrowser
+main

From c8b45cb9672f946e17cb0e3d2a6138c3ddd3eae7 Mon Sep 17 00:00:00 2001
From: UmutKzl <kzzzl@proton.me>
Date: Sat, 11 Jul 2026 12:53:53 +0300
Subject: [PATCH 3/8] chore(helium-browser): format the code

---
 .../browsers/helium-browser.sh                | 50 ++++++++++---------
 1 file changed, 26 insertions(+), 24 deletions(-)

diff --git a/core/tabs/applications-setup/browsers/helium-browser.sh b/core/tabs/applications-setup/browsers/helium-browser.sh
index bf3093e01..5eef3229f 100755
--- a/core/tabs/applications-setup/browsers/helium-browser.sh
+++ b/core/tabs/applications-setup/browsers/helium-browser.sh
@@ -3,30 +3,32 @@
 . ../../common-script.sh
 
 installHeliumBrowser() {
-    if ! command_exists Helium && ! command_exists helium; then
-        printf "%b\n" "${YELLOW}Installing Helium Browser...${RC}"
-        case "$PACKAGER" in
-        pacman)
-            "$AUR_HELPER" -S --needed --noconfirm helium-browser-bin
-            ;;
-        dnf)
-            "$ESCALATION_TOOL" "$PACKAGER" copr enable imput/helium
-            "$ESCALATION_TOOL" "$PACKAGER" install -y helium-bin
-            ;;
-        nala|apt-get)
-            "$ESCALATION_TOOL" "$PACKAGER" install -y curl
-            curl -fsSL https://raw.githubusercontent.com/imputnet/helium-linux/main/pubkey.asc | "$ESCALATION_TOOL" gpg --dearmor -o /usr/share/keyrings/helium.gpg
-            echo "deb [signed-by=/usr/share/keyrings/helium.gpg] https://pkg.helium.computer/deb stable main" | "$ESCALATION_TOOL" tee /etc/apt/sources.list.d/helium.list
-            "$ESCALATION_TOOL" "$PACKAGER" update
-            "$ESCALATION_TOOL" "$PACKAGER" install -y helium-bin
-        ;;
-        *)
-            printf "%b\n" "${RED}Helium doesn't support ${PACKAGER}${RC}"
-            ;;
-        esac
-    else
-        printf "%b\n" "${GREEN}Helium Browser is already installed.${RC}"
-    fi
+  if ! command_exists Helium && ! command_exists helium; then
+    printf "%b\n" "${YELLOW}Installing Helium Browser...${RC}"
+    case "$PACKAGER" in
+    pacman)
+      "$AUR_HELPER" -S --needed --noconfirm helium-browser-bin
+      ;;
+    dnf)
+      "$ESCALATION_TOOL" "$PACKAGER" copr enable imput/helium
+      "$ESCALATION_TOOL" "$PACKAGER" install -y helium-bin
+      ;;
+    nala | apt-get)
+      "$ESCALATION_TOOL" "$PACKAGER" install -y curl
+      curl -fsSL https://raw.githubusercontent.com/imputnet/helium-linux/main/pubkey.asc | "$ESCALATION_TOOL" gpg --dearmor -o /usr/share/keyrings/helium.gpg
+      echo "deb [signed-by=/usr/share/keyrings/helium.gpg] https://pkg.helium.computer/deb stable main" | "$ESCALATION_TOOL" tee /etc/apt/sources.list.d/helium.list
+      "$ESCALATION_TOOL" "$PACKAGER" update
+      "$ESCALATION_TOOL" "$PACKAGER" install -y helium-bin
+      ;;
+    *)
+      printf "%b\n" "${RED}Helium doesn't support ${PACKAGER}${RC}"
+      ;;
+    esac
+  else
+    printf "%b\n" "${GREEN}Helium Browser is already installed.${RC}"
+  fi
+}
+
 uninstallHeliumBrowser() {
   if command_exists Helium && commands_exists helium; then
     printf "%b\n" "${YELLOW}Removing Helium Browser...${RC}"

From 2823a2cdfd7b73dd5a294d257867f1ed9bf1b5a0 Mon Sep 17 00:00:00 2001
From: UmutKzl <kzzzl@proton.me>
Date: Sat, 11 Jul 2026 14:20:26 +0300
Subject: [PATCH 4/8] fix(helium-browser): fix an operator issue with command
 check

---
 core/tabs/applications-setup/browsers/helium-browser.sh | 1 +
 1 file changed, 1 insertion(+)

diff --git a/core/tabs/applications-setup/browsers/helium-browser.sh b/core/tabs/applications-setup/browsers/helium-browser.sh
index 5eef3229f..35435d890 100755
--- a/core/tabs/applications-setup/browsers/helium-browser.sh
+++ b/core/tabs/applications-setup/browsers/helium-browser.sh
@@ -31,6 +31,7 @@ installHeliumBrowser() {
 
 uninstallHeliumBrowser() {
   if command_exists Helium && commands_exists helium; then
+  if command_exists Helium || command_exists helium; then
     printf "%b\n" "${YELLOW}Removing Helium Browser...${RC}"
     case "$PACKAGER" in
     pacman)

From eda5b235a2eb816383854089c101aec71abdc1f7 Mon Sep 17 00:00:00 2001
From: UmutKzl <kzzzl@proton.me>
Date: Sat, 11 Jul 2026 14:20:52 +0300
Subject: [PATCH 5/8] fix(helium-browser): change wrong uninstall command

---
 core/tabs/applications-setup/browsers/helium-browser.sh | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/core/tabs/applications-setup/browsers/helium-browser.sh b/core/tabs/applications-setup/browsers/helium-browser.sh
index 35435d890..12c0ee698 100755
--- a/core/tabs/applications-setup/browsers/helium-browser.sh
+++ b/core/tabs/applications-setup/browsers/helium-browser.sh
@@ -30,7 +30,6 @@ installHeliumBrowser() {
 }
 
 uninstallHeliumBrowser() {
-  if command_exists Helium && commands_exists helium; then
   if command_exists Helium || command_exists helium; then
     printf "%b\n" "${YELLOW}Removing Helium Browser...${RC}"
     case "$PACKAGER" in
@@ -38,7 +37,7 @@ uninstallHeliumBrowser() {
       "$ESCALATION_TOOL" "$PACKAGER" -R --noconfirm --needed helium-browser-bin
       ;;
     dnf)
-      "$ESCALATION_TOOL" "$PACKAGER" uninstall helium-bin
+      "$ESCALATION_TOOL" "$PACKAGER" remove -y helium-bin
       "$ESCALATION_TOOL" "$PACKAGER" copr disable imput/helium
       ;;
     nala | apt-get)

From 91bddd4b706f2965a9510503ffdcb0bcb77d947e Mon Sep 17 00:00:00 2001
From: UmutKzl <kzzzl@proton.me>
Date: Sat, 11 Jul 2026 14:21:23 +0300
Subject: [PATCH 6/8] chore(helium-browser): remove unneeded things

---
 core/tabs/applications-setup/browsers/helium-browser.sh | 2 --
 1 file changed, 2 deletions(-)

diff --git a/core/tabs/applications-setup/browsers/helium-browser.sh b/core/tabs/applications-setup/browsers/helium-browser.sh
index 12c0ee698..5597bea21 100755
--- a/core/tabs/applications-setup/browsers/helium-browser.sh
+++ b/core/tabs/applications-setup/browsers/helium-browser.sh
@@ -64,6 +64,4 @@ main() {
 }
 
 checkEnv
-checkEscalationTool
-checkAURHelper
 main

From 79bcb023dc69ba5a06d998db019de8ee330966ec Mon Sep 17 00:00:00 2001
From: UmutKzl <kzzzl@proton.me>
Date: Fri, 17 Jul 2026 21:55:06 +0300
Subject: [PATCH 7/8] fix(helium-browser): pacman remove helium

there's no --needed flag for pacman -R
---
 core/tabs/applications-setup/browsers/helium-browser.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/core/tabs/applications-setup/browsers/helium-browser.sh b/core/tabs/applications-setup/browsers/helium-browser.sh
index 5597bea21..54a299204 100755
--- a/core/tabs/applications-setup/browsers/helium-browser.sh
+++ b/core/tabs/applications-setup/browsers/helium-browser.sh
@@ -34,7 +34,7 @@ uninstallHeliumBrowser() {
     printf "%b\n" "${YELLOW}Removing Helium Browser...${RC}"
     case "$PACKAGER" in
     pacman)
-      "$ESCALATION_TOOL" "$PACKAGER" -R --noconfirm --needed helium-browser-bin
+      "$ESCALATION_TOOL" "$PACKAGER" -R --noconfirm helium-browser-bin
       ;;
     dnf)
       "$ESCALATION_TOOL" "$PACKAGER" remove -y helium-bin

From 95e8a1e989837910a499a511ee6acf457925bf61 Mon Sep 17 00:00:00 2001
From: UmutKzl <kzzzl@proton.me>
Date: Fri, 17 Jul 2026 21:56:17 +0300
Subject: [PATCH 8/8] fix(helium-browser): posix usability and packager update

- i forgot to add update and purge commands

- better posix usability (changed [[]] to [])
---
 core/tabs/applications-setup/browsers/helium-browser.sh | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/core/tabs/applications-setup/browsers/helium-browser.sh b/core/tabs/applications-setup/browsers/helium-browser.sh
index 54a299204..84086845b 100755
--- a/core/tabs/applications-setup/browsers/helium-browser.sh
+++ b/core/tabs/applications-setup/browsers/helium-browser.sh
@@ -41,8 +41,10 @@ uninstallHeliumBrowser() {
       "$ESCALATION_TOOL" "$PACKAGER" copr disable imput/helium
       ;;
     nala | apt-get)
-      [[ -f "/usr/share/keyrings/helium.gpg" ]] && rm "/usr/share/keyrings/helium.gpg"
-      [[ -f "/etc/apt/sources.list.d/helium.list" ]] && rm "/etc/apt/sources.list.d/helium.list"
+      [ -f "/usr/share/keyrings/helium.gpg" ] && "$ESCALATION_TOOL" rm "/usr/share/keyrings/helium.gpg"
+      [ -f "/etc/apt/sources.list.d/helium.list" ] && "$ESCALATION_TOOL" rm "/etc/apt/sources.list.d/helium.list"
+      "$ESCALATION_TOOL" "$PACKAGER" update
+      "$ESCALATION_TOOL" "$PACKAGER" purge -y helium-bin
       ;;
     esac
   else