Waterfox Installation Script

This repository is mirrored here https://github.com/msmafra/wfxi

Disclaimer

• This script comes with no warranty. Use at your own risk.
• This project is not affiliated with Waterfox in any way.

Get more infomation about the Waterfox browser in its https://www.waterfox.net/en-US/docs/faq/

Obtaining the script

From a compressed source

Via compressed file

From 2.0.2 onwards, the compressed files only contains the wfxi script. So you can uncompress it and run from the same created folder. One of the compressed files can be downloaded and extracted (tar.gz, tar.bz2, tar or zip).

Check https://gitlab.com/msmafra/wfxi/-/releases to download the latest.

❯ curl -sLO -C- https://gitlab.com/msmafra/wfxi/-/archive/v2.0.2/wfxi-v2.0.2.tar.bz2
❯ tar xvf wfxi-v2.0.2.tar.bz2
❯ cd wfxi-v2.0.2

From the raw latest version

❯ curl -sLO -C- https://gitlab.com/msmafra/wfxi/raw/main/wfxi

Cloning the repo

❯ git clone https://gitlab.com/msmafra/wfxi.git
❯ cd wfxi

Installing

To install it use the self paramenter. It will copy itself by default to $HOME/.local/bin. Using self system will instead place it inside /usr/local/bin.

❯ sh ./wfxi self
# Or
❯ sh ./wfxi self system

Requirements

Goes without saying as it is a bash script, it depends on: curl, grep, rm, sha512sum, tar and sed.

Usage

self

"Installs" and removes wfxi. Running wfxi self will show current installed version and remote available version and it will self install if not found or if the running one is newer (defaults to $HOME/.local/bin).

❯ wfxi self
# Waterfox Installation Script (wfxi)
Available: 2.0
Installed: 2.0.1
[p] Installing /home/dilbert/.local/bin/wfxi
'/home/dilbert/Projects/wfxi/wfxi' -> '/home/dilbert/.local/bin/wfxi'
[i] wfxi installed.

Running wfxi self system will install it to /usr/local/bin

❯ wfxi self system
# Waterfox Installation Script (wfxi)
Available: 2.0
Installed: 2.0.1
[p] Installing /usr/local/bin/wfxi
'/home/dilbert/Projects/wfxi/wfxi' -> '/usr/local/bin/wfxi'
[i] wfxi installed.

Running wfxi self remove will "uninstall" the script

❯ wfxi self remove
# Waterfox Installation Script (wfxi)
Available: 2.0
Installed: 2.0.1
[w] Self removing
removed '/home/dilbert/.local/bin/wfxi'
removed '/usr/local/bin/wfxi'
[i] wfxi deleted

do

"Installs" Waterfox. Downloads, checksums and extracts Waterfox to /opt/waterfox, creates a symbolic link in /usr/local/bin and dot desktop file inside /usr/share/applicatons.

❯ wfxi do
# Waterfox Installation Script (wfxi)
[p] Extracting /home/marcelo/Downloads/waterfox-G6.0.3.tar.bz2 contents to /opt/waterfox
[p] Creating symbolic link
[p] Creating a symbolic link inside /usr/local/bin
'/usr/local/bin/wfxi' -> '/opt/waterfox/waterfox'
[p] Generating the desktop file
[p] Creating the /usr/share/applications/waterfox.desktop...
[p] /usr/share/applications/waterfox.desktop created.
[p] done

delete

"Uninstalls" Waterfox. Deletes Watefox from your system removing: /usr/share/applications/waterfox.desktop, /usr/local/bin/waterfox and the folder /opt/waterfox.

❯ /wfxi do delete
# Waterfox Installation Script (wfxi)
[w] Deleting: /opt/waterfox /usr/share/applications/waterfox.desktop /usr/local/bin/waterfox
[i] Cache, favorites, configurations, and .desktop file to non standard path won't be deleted
[p] deleted

get

Downloads Waterfox's .tar.bz2 to $HOME/Downloads and checksums the file, shows most recent remote version with get version, shows the full url with get url or shows the file name with get file

❯ wfxi get file
# Waterfox Installation Script (wfxi)
waterfox-G6.0.3.tar.bz2⏎

❯ wfxi get url
# Waterfox Installation Script (wfxi)
https://cdn1.waterfox.net/waterfox/releases/G6.0.3/Linux_x86_64/waterfox-G6.0.3.tar.bz2⏎

❯ wfxi get version
# Waterfox Installation Script (wfxi)
G6.0.3

desktop

Generates the waterfox.desktop file (defaults to /usr/share/applications). desktop "" will create a copy on provided path.

❯ wfxi desktop "$HOME"
# Waterfox Installation Script (wfxi)
[p] Creating the /home/dilbert/waterfox.desktop...
[p] Applying correct permissions to /home/dilbert/waterfox.desktop
[p] /home/dilbert/waterfox.desktop created.

more info

❯ wfxi help
# Waterfox Installation Script (wfxi)

Help:

  current
        Checks if the current version of Waterfox in your system.
  desktop
        Generates the desktop file to /usr/share/applications or to a path of your choosing.
        Example to create /home/marcelo/waterfox.desktop:
        wfxi desktop ~ 
  do
        Checksums waterfox downloaded file, installs/extracts it to /opt/waterfox, creates a symlink and a dot desktop file.
  get
        get Downloads the latest or a specified version of Waterfox and its checksum file.
        Shows the file name with get file or shows the full url with get url
  help
        Shows this help.
  need
        Shows the list of dependencies for wfxi.
  remove
        Removes Waterfox from your system. Won't remove your configs and cache.
  self
        Checks if there is a newer version of wfxi. Auto installs if the running one is newer.
        Using the system parameter installs wfxi to /usr/local/bin.
  usage
        Shows a quick list of commands to use this script.
  version
        Shows the current wfxi version.

License

GPLv3