chromium-installer

1.0.2 • Public • Published

Build Status node Maintenance NPM

About

I developed this tool to securely install or update the latest Chromium snapshot version directly from Google servers. This tool is compatible with Linux, macOS (Apple Silicon), Windows, and rooted Android devices, requiring only two main dependencies (seven, including sub-dependencies). Its primary function is to download the latest snapshot file from https://www.googleapis.com/ and then unzip the files into /opt/chromium/ for Linux or C:\Program Files\Chromium for Windows using a module named yauzl. On macOS due to OS restrictions this tool only downloads .zip file to ~/Downloads and the user have to manually install it.

How to use on PC

  1. Install from NPM globally using: npm install -g chromium-installer
  2. Set keys once either for Linux (nonroot) ./scripts/set-API-keys-Linux.sh or Windows .\scripts\set-API-Keys-Windows.bat
  3. Download & install as admin/root using the following command chromium-installer
  4. Don't forget to make chrome executable on Linux.

Linux (sandbox crash)

There is a bug where sandboxing may not work and make Chromium crash. Some linux distributions does not support unprivileged user namespaces and may need the following kernel tweak.

sysctl -w kernel.unprivileged_userns_clone=1

*May Compromise System Security

How to use on Android (root)

  1. Download and install Termux.
  2. Make sure you have installed the root and nodej.js packages, if not run (non root) pkg install tsu && pkg install nodejs
  3. Install the package using npm install -g chromium-installer (non root)
  4. Now switch to root using tsu and run chromium-installer-updater
  5. Install the apks using the following command:
    pm install -r /data/local/tmp/chromium-installer/chrome-android/apks/ContentShell.apk
    

TIP: Alternatively skip the steps 4 & 5 and run the script located at ./scripts/android.sh using the following command as root: /data/data/com.termux/files/usr/lib/node_modules/chromium-installer/scripts/android.sh

WARNING! The following guide was tested on Android 9.

Todo

  • Make it default browser using a script
  • Better terminal UI
  • API version
  • Create desktop shortcuts
  • Reach 100% Code Coverage

Tested

Linux Debian Stretch 9 (Gnome Shell 3.22.3)

Windows 10 (1709)

Nodejs 11.9.0/12.15/0

Android 9

macOS 14

Package Sidebar

Install

npm i chromium-installer

Weekly Downloads

127

Version

1.0.2

License

GPL-3.0

Unpacked Size

55.7 kB

Total Files

18

Last publish

Collaborators

  • crafter999