Config

nbrowser uses a simple shell-based config file, which is located in $HOME/.config/nbrowser/config.

if the file does not exist, just create it

Variables

NBROWSER_DEFAULT_SEARCH   Default search engine to use. (default: duckduckgo)
NBROWSER_PDF_VIEWER       Pdf Viewer to use when opening pdf files. (default: zathura)
NBROWSER_HTML_EDITOR      TEXT Editor to use when opening html files. (default: subl)

bangs and nbrowser share the same shell environment, so you can add variables that needed by specific bang to the config file like APIKEYS...

Functions

i made it possible to overwrite two functions: _copy_to_clipboard and _clean_url

the first one as the name indicate is used to copy text to the clipboard, the version that is included in the script use xclip as backend, but you may want to use something else.

the seconde function is _clean_url which try to remove tracking elements from URL, it is very basic, so you may want to improve it or replace it with something better (using ClearURLs rules)

or if you wan't to completely disable it add this to your config file

_clean_url(){
	echo "$@"
}

Browsers

you can add additional browsers by adding something like this to your config file:

browser_count=$((browser_count+1))
installed_browsers[$browser_count]="Browser Name	:	path/to/browser -args"

the $browser_count variable is used to keep track of how many browsers in the list,so you don't accidentally overwrite the list

so every time you want to add a browser you need to add browser_count=$((browser_count+1)) before it like this

browser_count=$((browser_count+1))
installed_browsers[$browser_count]="Browser1 Name	:	path/to/browser1 -args"
browser_count=$((browser_count+1))
installed_browsers[$browser_count]="Browser2 Name	:	path/to/browser2 -args"
browser_count=$((browser_count+1))
installed_browsers[$browser_count]="Browser3 Name	:	path/to/browser3 -args"

and this is an example of how to add a firefox profile to the list

browser_count=$((browser_count+1))
installed_browsers[$browser_count]="Firefox ProfileName	:	$(which firefox) -P profilename"