Ebrowser: keyboard-friendly minimal suckless web browser

Ebrowser is designed with the philosophy of Android uweb browser (gitlab).

Note: Usually electron apps are heavyweight as they use browsers for simple things. Ebrowser uses core chromium effectively and very lightweight. Recommend to install electron separately.

Installing (for Windows, MacOS and Linux)

Install with prebuilt binaries

You can find prebuilt binaries here.

Install ebrowser and electron separatedly
Install ebrowser

Either download and unzip ebrowser package directly from any of npm mirror sites like npmmirror or with nodejs by

npm install ebrowser

OR

git clone https://github.com/torappinfo/ebrowser

OR "git clone"/download files directly from any of mirror repositories and ebrowser is under the folder "misc/ebrowser".

Install electron

Before you can run ebrowser, you need to install electron either with nodejs by

npm install electron

OR download and unzip electron binary directly from github or mirrors like npmmirror.

Run ebrowser
electron ~/node_modules/ebrowser

OR

electron [the-path-of-folder-with-downloaded-ebrowser-files]
Update app quickly without updating chromium

Pressing "Alt" to show the menu bar and choose "Check for updates" under "Help". OR

Type ":update" in the address bar and press "enter" key to update.

Key shortcuts

Address bar commands

Like any popular browser, the very first word in address bar if defined in "search.json" identifies a search engine. Moreover, the address bar serves as command line interface:

Commands in no-focus mode (this mode is similar to vi Normal mode)

Pressing "ESC" to enter no-focus mode if not sure.

The other commands are defined in "mapkeys.json", which will map keys to address bar commands.

Configuration files

Javascript at three levels

examples for ":js"/":bjs" commands
:js bJS=true //allow external Javascript files for web pages
:js bJS=false //disallow external Javascript files for web pages
:bjs bHistory=true //to record url history
:bjs bQueryHistory=true //to record query/command history

New usages

License

You can copy or modify the code/program under the terms of the GPL3.0 or later versions.

Last Modified: 29 September 2024
update ebrowser README