100% written by LLM (Claude)

DuckDuckGo Bangs-style search redirect service.

• Bang search: g hello → Google search for "hello"
• Default engine: Search without bang uses your default engine
• Homepage: yt (no query) → YouTube home
• Custom triggers: !g, @g, #g - any format you want
• Search suggestions: live autocomplete from the target engine as you type (Firefox)
• Auto-reload: Config changes apply without restart

default_bang: g

bangs:
  - trigger: g
    name: Google
    url_template: "https://www.google.com/search?q={{{s}}}"
    suggest_url_template: "https://suggestqueries.google.com/complete/search?client=firefox&q={{{s}}}"

  - trigger: yt
    name: YouTube
    url_template: "https://www.youtube.com/results?search_query={{{s}}}"
    suggest_url_template: "https://suggestqueries.google.com/complete/search?client=firefox&ds=yt&q={{{s}}}"

  - trigger: gh
    name: GitHub
    url_template: "https://github.com/search?q={{{s}}}"

docker run -d -p 8080:8080 \
  -v $(pwd)/bangs.yaml:/app/bangs.yaml \
  ghcr.io/psi59/bangs:latest

1. Open http://localhost:8080/ in Firefox
2. Right-click the address bar → Add "Bangs" (or Settings → Search → Search Shortcuts, the page offers the engine automatically)
3. Set Bangs as your default search engine
4. Type g hello in the address bar — suggestions from the target engine appear as you type (for bangs with suggest_url_template)

1. Settings → Search engine → Manage search engines → Add
2. Configure:
   • Search engine: Bangs
   • Shortcut: b
   • URL: http://localhost:8080/search?q=%s
3. Type b g hello in address bar → Google search for "hello"

1. After adding as custom search engine
2. Find "Bangs" in the list, click ⋮ → Make default
3. Now type g hello directly in address bar

# Install with Go
go install github.com/psi59/bangs@latest

# Or build from source
git clone https://github.com/psi59/bangs.git
cd bangs && go build .

# Run
BANGS_CONFIG_PATH=./bangs.yaml ./bangs

MIT