README.md

Kagi Bangs

This is an open-source, community maintained repository of bangs used by Kagi Search.

You can submit changes to improve accuracy of existing bangs as well as create new bangs for use in Kagi Search.

Accepted changes are deployed to our website weekly.

Contribution Guidelines

Kagi Staff and maintainers of this repo have final say, but a good bang submission should follow some basic guidelines.

• The website must be reasonably well-known and widely used. For example, popular commercial services and forums are OK. Low-traffic independent sites, such as startups, local businesses, or personal blogs, are not OK.

• The trigger must be specific to the website, not a generic term or word. For example, "amazon.com" can have "!amazon" but not "!groceries".

• Each trigger must be unique. You can test your trigger on Kagi to see if a bang already exists with that trigger.

• You can use the Categories list below to find the Category and Subcategory that fits best. If you cannot find one, it can be omitted, or we can consider adding a new one.

• If the bang you wish to add does not fit the above criteria, you can still create a custom bang on your own Kagi account for your own use! See our documentation for details.

• Any modifications to bangs should be made to /data/bangs.json. /data/kagi_bangs.json provides bangs internal to Kagi itself (i.e., image search, search in a specific region)

Region Bangs

Currently, not all 2-char ISO country codes for regions Kagi supports are mapped to region bangs. Adding new region bangs will be handled on a case-by-case basis.

List of region codes with existing triggers

Trigger	Current site	Category	Region
ac	Allociné	Entertainment	Ascension Island
ad	Ask Different	Entertainment	Andorra
ae	aliexpress.com	Shopping	United Arab Emirates
af	Acronym Finder	Research	Afghanistan
ag	Android Geeks	Tech	Antigua and Barbuda
ai	Kagi Assistant		Anguilla
al	AniList	Entertainment	Albania
am	Amazon.com	Shopping	Armenia
ao	Amazon Orders	Shopping	Angola
ar	all recipes	Research	Argentina
as	Kagi Assistant		American Samoa
aw	Arch Linux Wiki	Tech	Aruba
ax	androidxref	Tech	Åland Islands
az	Amazon.com	Shopping	Azerbaijan
ba	Beer Advocate	Entertainment	Bosnia and Herzegovina
bb	Bitbucket	Tech	Barbados
bd	baidu	Online Services	Bangladesh
bf	BuzzFeed	Entertainment	Burkina Faso
bg	BibleGateway	Online Services	Bulgaria
bh	B&H Photo Video	Shopping	Bahrain
bi	Bing Images	Online Services	Burundi
bl	The British Library Catalogue	Research	Saint Barthélemy
bm	bing maps	Online Services	Bermuda
bn	Barnes and Noble	Shopping	Brunei
bo	Boerse Online	News	Bolivia
bq	BloombergQuint	News	Bonaire, Sint Eustatius and Saba
bs	Bing Shopping	Shopping	Bahamas
bt	Microsoft/Bing Translator	Online Services	Bhutan
bv	Bing Videos	Online Services	Bouvet Island
bw	Bing Weather	News	Botswana
cc	Openverse Creative Commons Search	Online Services	Cocos (Keeling) Islands
cd	Collins Dictionary	Research	Congo, Democratic Republic of the
cg	CultureGraph	Research	Congo
ci	CodeIgniter	Tech	Côte d'Ivoire
ck	Chefkoch.de	Research	Cook Islands
cl	Craigslist	Shopping	Chile
cr	codereview.stackexchange.com	Tech	Costa Rica
cu	CanIUse	Tech	Cuba
cv	Cross Validated	Tech	Cabo Verde
cw	CodeWars	Tech	Curaçao
dj	Django documentation	Tech	Djibouti
dm	Daily Motion	Multimedia	Dominica
do	DigitalOcean	Tech	Dominican Republic
dz	Deezer	Multimedia	Algeria
ec	Ecosia	Online Services	Ecuador
ee	Kagi Search	Tech	Estonia
eg	Kagi Search	Entertainment	Egypt
eh	English Heritage	Entertainment	Western Sahara
er	Erowid	Research	Eritrea
et	El Tiempo	News	Ethiopia
fi	finanzen.net	Online Services	Finland
fj	Funnyjunk	Entertainment	Fiji
fk	Flipkart	Shopping	Falkland Islands
fm	Filmaster	Multimedia	Micronesia (Federated States of)
fo	File.org	Research	Faroe Islands
ga	Google Australia	Online Services	Gabon
gd	Google Docs	Online Services	Grenada
ge	Google Encrypted	Online Services	Georgia
gf	Google Finance	Online Services	French Guiana
gg	Google Groups	Online Services	Guernsey
gh	GitHub	Tech	Ghana
gi	Google Images	Online Services	Gibraltar
gl	OpenGL	Tech	Greenland
gm	Google Maps	Online Services	Gambia
gn	Google News	News	Guinea
gp	Google Play	Tech	Guadeloupe
gq	GQ	News	Equatorial Guinea
gr	Goodreads	Multimedia	Greece
gs	Google Shopping	Online Services	South Georgia and the South Sandwich Islands
gt	Google Translate	Online Services	Guatemala
gu	Kagi Search	News	Guam
gw	Gentoo Wiki	Tech	Guinea-Bissau
gy	Google	Online Services	Guyana
hk	HackTips	Tech	Hong Kong
hm	HERE maps	Online Services	Heard Island and McDonald Islands
hn	Hacker News	Tech	Honduras
ht	HookTube	Multimedia	Haiti
ie	Kagi Search	Online Services	Ireland
is	Ilmainen Sanakirja	Online Services	Iceland
je	Tanoshii Japanese	Research	Jersey
jm	Joe Monster	Entertainment	Jamaica
jo	Jotrin Electronics	Shopping	Jordan
kg	KG-Portal	Entertainment	Kyrgyzstan
kh	Kubeapps Hub	Tech	Cambodia
km	Karaoke Mugen	Multimedia	Comoros
kn	Knoema	Research	Saint Kitts and Nevis
kp	Kupujemprodajem	Shopping	North Korea
la	Langenscheidt	Research	Laos
lb	letterboxd	Entertainment	Lebanon
lc	Laracasts	Tech	Saint Lucia
li	LinkedIn	Online Services	Liechtenstein
lk	LolKing	Entertainment	Sri Lanka
ls	LittleSis	Research	Lesotho
lt	LibraryThing	Multimedia	Lithuania
lu	Liberty University	Research	Luxembourg
lv	Livermore library	Research	Latvia
ma	Memory Alpha	Entertainment	Morocco
mc	Metacritic	Online Services	Monaco
md	Microsoft Docs	Tech	Moldova
me	Mass Effect Wiki	Entertainment	Montenegro
mf	Morguefile	Multimedia	Saint Martin
mh	The Monster Hunter Wiki	Entertainment	Marshall Islands
mk	Mechanical Keyboards	Shopping	North Macedonia
ml	Google Maps Lite	Online Services	Mali
mm	Macmillan Dictionary	Online Services	Myanmar
mn	medicinanet	Research	Mongolia
mo	MathOverflow	Research	Macao
mp	MenuPages	Research	Northern Mariana Islands
mq	MapQuest	Online Services	Martinique
mr	Mac Rumors	Tech	Mauritania
ms	Microsoft	Tech	Montserrat
mt	Multitran	Research	Malta
mu	MacUpdate	Tech	Mauritius
mv	Myvideo	Multimedia	Maldives
mw	Merriam-Webster Dictionary	Research	Malawi
mx	MxToolbox	Tech	Mexico
mz	Mittelbayerische Zeitung	News	Mozambique
na	NAVER	Online Services	Namibia
nc	Namecheap	Tech	New Caledonia
ne	Newegg	Shopping	Niger
nf	Netflix	Entertainment	Norfolk Island
ng	AngularJS	Tech	Nigeria
ni	National Instruments	Tech	Nicaragua
np	The Noun Project	Multimedia	Nepal
nr	Nixpkgs Repository	Tech	Nauru
nu	Nu.nl	News	Niue
pa	Páginas Amarillas	Online Services	Panama
pe	Dicionário Porto Editora	Research	Peru
pf	PrintFriendly	Online Services	French Polynesia
pg	Project Gutenberg	Multimedia	Papua New Guinea
ph	Product Hunt	Shopping	Philippines
pk	Peekier	Research	Pakistan
pm	pubmed	Research	Saint Pierre and Miquelon
pn	Amazon Prime NOW	Shopping	Pitcairn
pr	PR Vademecum Argentina	Research	Puerto Rico
ps	Playstation	Shopping	Palestine
pw	Pricewatch	Shopping	Palau
py	Python	Tech	Paraguay
ro	admin.ch	Research	Romania
ru	RedUSERS	Tech	Russia
rw	RationalWiki	Research	Rwanda
sa	Scientific American	News	Saudi Arabia
sb	SwagBucks	Online Services	Solomon Islands
sc	SoundCloud	Multimedia	Seychelles
sd	SlickDeals	Shopping	Sudan
sg	Sourcegraph	Tech	Singapore
sh	Shodan	Tech	Saint Helena, Ascension and Tristan da Cunha
sj	sitejabber	Online Services	Svalbard and Jan Mayen
sk	Songkick	Entertainment	Slovakia
sl	Setlist.fm	Multimedia	Sierra Leone
sm	Smashing Magazine	News	San Marino
sn	SoylentNews	News	Senegal
so	Stack Overflow	Tech	Somalia
sr	reddit	Entertainment	Suriname
ss	SurreySearch	Research	South Sudan
st	stocktwits	News	Sao Tome and Principe
sv	Voat	Entertainment	El Salvador
sx	Stack Exchange	Online Services	Sint Maarten
sy	Big Huge Thesaurus	Research	Syria
sz	Süddeutsche Zeitung	News	Eswatini
ta	tripadvisor	Research	Tristan da Cunha
tc	Techcrunch	Tech	Turks and Caicos Islands
td	TimeAndDate	Online Services	Chad
tf	Tensor Flow	Tech	French Southern Territories
tj	Taco John's	Shopping	Tajikistan
tl	Team Liquid	Entertainment	Timor-Leste
tm	Trade Me	Shopping	Turkmenistan
tn	Times Now	News	Tunisia
tr	Google Translate	Translation	Turkey
tt	Texas Tribune	News	Trinidad and Tobago
tv	tv.com	Entertainment	Tuvalu
tz	timeanddate	News	Tanzania
ug	Ultimate Guitar	Entertainment	Uganda
va	Vim Awesome	Tech	Vatican City
vc	VoucherCodes	Shopping	Saint Vincent and the Grenadines
ve	VideoETA	Entertainment	Venezuela
vg	Google	Online Services	British Virgin Islands
wf	fr.wikipedia.org	Online Services	Wallis and Futuna
ws	Wikisource	Multimedia	Samoa
yt	YouTube	Multimedia	Mayotte
zw	Zelda Wiki	Entertainment	Zimbabwe

Bang Format

{
  "s": "Metacritic",
  "d": "www.metacritic.com",
  "t": "mc",
  "u": "https://www.metacritic.com/search/{{{s}}}/",
  "c": "Online Services",
  "sc": "Search"
}

Key	Description	Required	Notes
s	Website name	yes
d	Domain	yes
t	Trigger	yes	May contain letters, numbers, dashes (-), and underscores (_). No spaces or other special characters.
u	URL template	yes	Use {{{s}}} for query placeholder.
c	Category	no
sc	Subcategory	no
fmt	Format flags	no	Array of strings; See below.

Format Flags

The fmt field exists to tweak the behavior of how the bang is executed. For the majority of bangs, you do not need to specify this - we use defaults that work for 99.9% of bangs. But, it can be useful depending on the behavior of the website.

The field is an array of strings that act as a list of flags:

Flag	Description
open_base_path	When the bang is invoked with no query, opens the base path of the URL (/) instead of any path given in the template (e.g., /search)
url_encode_placeholder	URL encode the search terms. Some sites do not work with this, so it can be disabled by omitting this.
url_encode_space_to_plus	URL encodes spaces as +, instead of %20. Some sites only work correctly with one or the other.

By default, all of these are enabled. If you specify fmt, you must exhaustively specify each options you would like enabled.

Categories

This is a list of possible categories, with their corresponding subcategories.

Entertainment

Subcategories

• Audio
• Blogs
• Blogs (intl)
• Comics
• Events
• Forum
• Games (Minecraft)
• Games (Pokemon)
• Games (WOW)
• Games (general)
• Games (offline)
• Games (specific)
• Misc
• Movies
• Music
• Radio
• Sports
• TV

Man Page

Subcategories

• Sysadmin

Multimedia

Subcategories

• Books
• Docs
• Games (general)
• General
• Images
• Movies
• Music
• Music (Folk)
• Music (Lyrics)
• Video

News

Subcategories

• Aggregators
• Broadcast
• Business
• International
• Magazine
• Magazine (car)
• Magazine (fashion)
• Newspaper
• Newspaper (intl)
• Online
• Specialty
• Weather

Online Services

Subcategories

• Events
• Google
• Jobs
• Maps
• Search
• Search (DDG)
• Search (Private)
• Search (Real-time)
• Search (non-US)
• Social
• Social (intl)
• Social news/links
• Sysadmin
• Tools
• Tools (URLs)
• Tools (fundraising)
• Tracking

Region search

No corresponding subcategories.

Research

Subcategories

• Academic
• Academic (biology)
• Academic (math/cs)
• Food
• Government
• Health
• Law
• Learning
• Learning (intl)
• Local
• Real Estate
• Reference
• Reference (fun)
• Reference (religion)
• Reference (science)
• Reference (words intl)
• Reference (words)
• Topical
• Travel

Shopping

Subcategories

• Big box/department
• Online
• Online (deals)
• Online (intl)
• Online (marketplace)
• Services
• Tech
• Tech (domains)

Tech

Subcategories

• Blogs
• Blogs (intl)
• Chakra
• Companies
• Cryptocurrency
• Design
• Domains
• Downloads
• Downloads (add-ons)
• Downloads (apps)
• Downloads (code)
• Downloads (software)
• Language (perl)
• Languages (.net)
• Languages (Crystal)
• Languages (Mathematica)
• Languages (Matlab)
• Languages (c++)
• Languages (clojure)
• Languages (cocoa)
• Languages (coldfusion)
• Languages (csharp)
• Languages (d)
• Languages (erlang)
• Languages (go)
• Languages (haskell)
• Languages (html)
• Languages (java)
• Languages (javascript)
• Languages (latex)
• Languages (lisp)
• Languages (lua)
• Languages (other)
• Languages (perl)
• Languages (php)
• Languages (python)
• Languages (r)
• Languages (racket)
• Languages (ruby)
• Languages (scala)
• Languages (scheme)
• Languages (vala)
• Languages (nix)
• Libraries/Frameworks
• Libraries/Frameworks (KDE)
• Libraries/Frameworks (wordpress)
• Programming
• Search (DDG)
• Startups
• Sysadmin
• Sysadmin (Arch)
• Sysadmin (Fedora)
• Sysadmin (FreeBSD)
• Sysadmin (Gentoo)
• Sysadmin (RedHat)
• Sysadmin (Ubuntu)
• Sysadmin (debian)
• Sysadmin (man)
• Sysadmin (network)
• Sysadmin (packages)
• Tools
• Tools (URLs)

Translation

Subcategories

• General
• Google

Did you know?

As a Kagi user, you can make your own custom bangs right now in the Custom Bangs settings page or the Search Shortcuts menu.

These will be instantly available to you and will override any global bangs.

This repository is for adding new or fixing existing global bangs to Kagi.

Credits

Kagi bangs are made possible by DuckDuckGo which invented the concept in 2008.