Firefox Add-on using the DuckDuckGo Zero-click Info API
Latest commit 4c15dd6 Jun 19, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
data remove icon Jun 16, 2017
doc big rewrite Jun 10, 2012
lib remove icon Jun 16, 2017
test test-main.js - fix main module path Jan 3, 2017
LICENSE fix: Fix Copyright in LICENSE Aug 2, 2016
Makefile Update Makefile to use jpm instead of cfx Jan 4, 2017 - add explanation for testing checklist Jan 17, 2017
icon_48.png fix: Icons in about:addons screen Jul 25, 2016
icon_64.png fix: Icons in about:addons screen Jul 25, 2016
package.json bump version Jun 19, 2017


DuckDuckGo enhancements for Firefox.

This addon can

  • add a handy DuckDuckGo toolbar button to your browser for easy access to !bang tags (removable).
  • add DuckDuckGo as your default search engine through the address bar, search bar and context right-click menu (reversible).
  • show DuckDuckGo instant answers on Google/Bing (removable).

Setting the partner parameter

First of all, there is a PARTNER_QUERY_ADDITION constant in lib/main.js that should be set to something like &t=partnerid in order to function properly.

Also, you might want to add the t parameter to the search engine definition which is located at data/search.xml. It usually has a form of <Param name="t" value="partnerid"/>.

You can easily automate both these steps by running

$ make partnerxpi PARTNER_ID=partnerid

which will do both steps for you and provided that you have the Add-on SDK installed it will try to build it for you into a file ddg_for_firefox-partnerid.xpi.


jpm is required.

  • Install through node: npm install jpm
  • Update PATH: export PATH="$HOME/node_modules/.bin/:$PATH"

Find more information on MDN

Testing Checklist

Since we don't yet have automated tests, here is a checklist of manual tests to perform:

  • Extension installs

  • Popup opens

  • Search box is empty

  • Search works and defaults to DDG

  • Click a bang, the bang is added to the search box

  • Click another bang, the bang in the search box is replaced

  • Search with bang works

  • Expand/collapse button on right of search hides the bang options

  • Click "I'm feeling ducky" and search. Redirects to first organic

  • Modified options, both in the popup and in the options.html page, are saved

  • When safe search is unchecked, the URL for a search contains the &kp=-1 parameter

  • When "remember last search" is checked, on popup open the search box will contain the last performed search