localbang

Cross-browser, cross-search-engine duckduckgo-like bangs

Installation

Binary release

Download the latest binary release from here and place it in a folder thats in $PATH e.g. /usr/local/bin.

Cargo intall

This is easier, but you have to build the binary yourself.

cargo install localbang

Usage

localbang <shortcuts_file> <search_engine>

This will start a local webserver on port http://localhost:8000/. Every path (e.g. http://localhost:8000/foo) will be redirected to the search engine (with the query "foo") provided as a second argument (defaults to google search).

Sysyemd

You can find a unit file in example/localbang.service that can be used to start localbang in systemd. Place this in /etc/systemd/user or ~/.config/systemd/user/ and then systemctl --user enable --now localbang.service to enable it.

Shortcuts file

The shortcuts file defined the bangs, which are available. It is a CSV file with two rows: the keyword and the url. Examle Shortcuts File

keyword

This is the phrase or letter (could be anything really) that will be used to trigger the search engine specified in the url column.

url

The search engine to use for the bang/keyword. This must include a %s as the placeholder for the query.

Browser integration

Note: Opensearch Integration is planned for the future.

Chrome

In Chrome you can directly add a custom search engine.

• Open the settings
• Select "Search engine" on the left
• Click "Manage search engines"
• Click "Add"
• Enter the name (e.g. "localbang")
• Enter any keyword. This only matters, if you are not going to use localbang as the default engine.
• Enter the url http://localhost:8000/%s
• Localbang should appear in the list under "Other search engines"
• (optional) Click the three dot menu and click "Make default", otherwise use the provided keyword.

Firefox

The easiest way is to use the Add custom search engine extension.

• Click the extension icon
• Enter any name (e.g. localbang)
• Enter the URL http://localhost:8000/%s
• Click "Add custom search engine"
• Follow the on screen steps (right-clicking the search bar and selecting it in the settings)