11 Home
Fr4nzD13trich edited this page 2026-01-15 14:00:46 +01:00

Helium Helper Script

Purpose

This script was initially designed to just update my Helium browser but over time and interest it got more functional and universal. With "little" tinkering it should be possible to apply this script to install, update & configure many kinds of releases from source like AppImages, binaries, etc...

Functions

  • Install Helium -i

  • Update Helium -u

  • Backup Helium -b

  • Update helium_helper.sh -S

  • Remove Helium -r

  • Add desktop launcher with extra functionality -l

  • Add alias to .shellrc -a --> tested with bash, fish and zsh

  • Compare local and remote app version -c

  • Show script version -s

  • Help -h

See detailed functions for more information.

Usage

Help

./helium_helper.sh -h

First Install

To initally install Helium browser via this script, download helium_helper.sh and make it executable:

wget https://lab.c95.org/fr4nz/helium-helper/raw/branch/main/helium_helper.sh && chmod +x helium_helper.sh

Run script with install parameter -i

  • Default install directory = $HOME/.apps/Helium
./helium_helper.sh -i
  • Custom install directory
./helium_helper.sh -i </PATH/TO/INSTALL_DIRECTORY>

NOTE: The install path specified won't be overridden within the script yet. Working on it...

OPTIONAL : Add alias to .shellrc | working in zsh, bash & fish

  • Default alias = helium-helper
./helium_helper.sh -a
  • Custom alias
./helium_helper.sh -a <ALIAS>

NOTE: The alias specified won't be overridden within the script yet. Working on it...


Updating

From launcher (if added during install or by running ./helium_helper.sh -l)

Checking for the latest version and updating can simply be done for the browser as well as the script by right clicking the app icon and choosing either update option, which will be run by helium_launcher_update.sh. This will perform a full backup and write a log.

Terminal

Updating can also be done by running:

  • Update Helium Browser
./helium_helper.sh -u
  • Update Helium Helper
./helium_helper.sh -S

Backing up

Backing up, by default, pulls all important files, folders & configuration and compresses an archive, which is stored in $HOME/.apps/Helium/assets

  • Default backup | equal to ./helium_helper.sh -b full /home/<USER>/.apps/Helium/assets/backup
./helium_helper.sh -b
  • Backup to custom path
./helium_helper.sh -b </PATH/TO/DESTINATION>

NOTE: The backup path specified won't be overridden within the script yet. Working on it...

  • Backup specific content
./helium_helper.sh -b <CONTENT_OPTION>
Option Description
full Backup everything app related
app Backup app only
script Backup script(s) only
config Backup launcher and config folder
  • Backup with specific compression
./helium_helper.sh -b <COMPRESSION_OPTION>
Option Description
pbzip2 Multi-thread bz2 compression (fastest)
gzip gz compression (medium)
bzip2 bz2 compression (slowest)
zip zip compression (medium)

Since this script is interactive, it doesn't keep logs.