HandyBrowser Versions Save

A Handshake enabled Chromium web browser and reference client; works with HSD and the HNSD light client. Use our example to build or integrate Handshake into any browser.

v0.2Mac

3 years ago
Before running HandyBrowser the first time, make sure you have Docker installed and running [Note: you don't need a Docker account, simply just the Docker service so we can install the dependencies for your Handshake node]:

MacOS Docker Download - https://docs.docker.com/docker-for-mac/release-notes/

After installing Docker, run the Docker application first, then open the HandyBrowser application for the install to begin. The setup will take just a few minutes, and it only needs to do this once, so please be patient. Use CTRL + Right Click to Open the launcher and accept the permissions if prompted with a security warning; this is due to HandyBrowser not coming from the official Mac App Store.

v0.2Windows

3 years ago

Before running HandyBrowser the first time, make sure you have Docker installed and running [Note: you don't need a Docker account, simply just the Docker service so we can install the dependencies for your Handshake node]:

Windows Docker Download - https://docs.docker.com/docker-for-windows/release-notes/

After installing Docker, run the Docker application first, then simply double click HandyBrowser.exe to begin the install. The setup will take just a few minutes, and it only needs to do this once, so please be patient.

v0.2Linux

3 years ago
Linux Prerequisite Module:

We need the command certutil in order to write the Root CA Certificate for HandyBrowser (and Chrome) to use.

On Ubuntu: sudo apt install libnss3-tools will install the certutil command

Before running HandyBrowser the first time, make sure you have Docker installed and running [Note: you don't need a Docker account, simply just the Docker service so we can install the dependencies for your Handshake node]:

Docker Download: - https://docs.docker.com/engine/install/

TO RUN HandyBrowser::

Docker needs sudo out of the box. If you dont want to run this app with sudo ::

sudo usermod -aG docker $USER

Once done, restart your device. after that you can start the browser either by double clicking HandyBrowser.desktop in this folder, or ./HandyBrowser

ELSE RUN LIKE:::
sudo ./HandyBrowser

Why sudo? Docker needs sudo permissions to run. Tinfoil hat on: Within the HandyBrowser Application, node.js is locked down to only file:// protocol (ie: the navigation tray layout/UI) and NOT anything coming in from the web. Any browser content will not have any permissions to node.js.

v0.1Windows

3 years ago
Before running HandyBrowser the first time, make sure you have Docker installed and running [Note: you don't need a Docker account, simply just the Docker service so we can install the dependencies for your Handshake node]:

Windows Docker Download - https://docs.docker.com/docker-for-windows/release-notes/

After installing Docker, run the Docker application first, then simply double click HandyBrowser.exe to begin the install. The setup will take just a few minutes, and it only needs to do this once, so please be patient.

v0.1Linux

3 years ago
Before running HandyBrowser the first time, make sure you have Docker installed and running [Note: you don't need a Docker account, simply just the Docker service so we can install the dependencies for your Handshake node]:

Docker Download: - https://docs.docker.com/engine/install/

TO RUN HandyBrowser::

Docker needs sudo out of the box. If you dont want to run this app with sudo ::

sudo usermod -aG docker $USER

Once done, restart your device. after that you can start the browser either by double clicking HandyBrowser.desktop in this folder, or ./HandyBrowser

ELSE RUN LIKE:::
sudo ./HandyBrowser

Why sudo? Docker needs sudo permissions to run. Tinfoil hat on: Within the HandyBrowser Application, node.js is locked down to only file:// protocol (ie: the navigation tray layout/UI) and NOT anything coming in from the web. Any windows loaded over http/https will not have any permissions to node.js.

v0.1Mac

3 years ago
Before running HandyBrowser the first time, make sure you have Docker installed and running [Note: you don't need a Docker account, simply just the Docker service so we can install the dependencies for your Handshake node]:

MacOS Docker Download - https://docs.docker.com/docker-for-mac/release-notes/

After installing Docker, run the Docker application first, then open the HandyBrowser application for the install to begin. The setup will take just a few minutes, and it only needs to do this once, so please be patient.