GithubHelp home page GithubHelp logo

bangs's Introduction

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.

bangs's People

Contributors

4amvim avatar adamaveray avatar adaptive avatar atemu avatar autumn-mck avatar bramhaag avatar brandonbeaumia avatar calebdavenport avatar dphelan avatar edsu avatar electricduck avatar erjanmx avatar fileformat avatar hollowshiroyuki avatar jacobwinters avatar jake-moss avatar lucasoe avatar mangero avatar maples3 avatar mathiazom avatar mlissner avatar mrjones2014 avatar nathandines avatar nobodywasishere avatar raybb avatar sylonin avatar vprelovac avatar whee avatar z-erica avatar z64 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

bangs's Issues

US Aviation Weather Center

Is your feature request related to a problem? Please describe.
This is new bang request, which I'm using currently as a personal customized bang.

Describe the solution you'd like
The Aviation Weather Center serves US and Global aviation weather data. Suggested bangs:

METAR & TAF data for an airport's ICAO code:

{
    "s": "AWC (Aviation Weather Center)",
    "d": "https://aviationweather.gov/",
    "t": "awc",
    "u": "https://aviationweather.gov/data/metar/?id={{{s}}}&hours=0&include_taf=yes",
    "c": "Research",
    "sc": "Travel"
  }

** Example **
!awc kjfk

MeteoSwiss search URL update

Describe the bug
The current encoded search URL for Meteo Suisse / Schweiz is not working, returning a 0 found page.

To Reproduce
Steps to reproduce the behavior:

  1. Input !msui Basel bang
  2. Observe "0 results found page"

Expected behavior
The search URL has changed and should be:
https://www.meteoswiss.admin.ch/search.html#query=%s

Working example
https://www.meteoswiss.admin.ch/search.html#query=Basel

!naob has changed their search url

Describe the bug
NAOB, provider for !naob has changed their search url.

To Reproduce
Steps to reproduce the behavior:

  1. Search !naob til
  2. Get 404 page

Expected behavior
Should show search results

Additional context
The new url is https://naob.no/s%C3%B8k?q={{{s}}}

Update man page bangs

Describe the bug
The die.net man pages haven't been updated in ages and may mislead users.

To Reproduce
Steps to reproduce the behavior:

  1. Search for !man php-fpm
  2. It will open https://www.die.net/search/?q=php-fpm#gsc.tab=0&gsc.q=php-fpm&gsc.page=1
  3. Click on the first result which is https://linux.die.net/man/8/php-fpm
  4. See that it says "This manpage describes php-fpm, version 5.3.3.", which was released 14 years ago

Expected behavior
I expect to see an up to date man page.

I propose to use the archlinux man pages, as they have the most up to date + all man pages one could dream of.

The format is https://man.archlinux.org/search?q={{{s}}}&go=Go. With go=Go it opens the first result directly, when omitted it shows all relevant results.

Additional context
Debian also has a man page website, but I can't even find php-fpm on it.

yth does not work as expected (Safari on macOS)

Describe the bug
YouTube handles loading the history page with a query not correctly (at least in Safari on macOS) since over a year (i also faced this with duckduckgo).

To Reproduce
!yth query -> (flashes) https://www.youtube.com/feed/history?query=query -> ignores query and redirects to https://www.youtube.com/feed/history

!yth -> https://www.youtube.com/feed/history?query= -> redirects to https://www.youtube.com

Expected behavior
As YouTube does not handle loading the page with a query parameter correctly, i propose removing the query altogether, so at least !yth behaves correctly instead of redirecting to the YouTube homepage.

If i load https://www.youtube.com/feed/history it reliably loads the Watch history page. So removing ?query= from the bang would increase reliability of this bang.

Additional context
Safari 17.4.1 @ macOS 14.4.1 (but as i said, i have this issue since "forever" (at least 1-2 years).

!apod does not work

Describe the bug
The apod bang does not work.

To Reproduce

type "milky way !apod"

You will hit

https://apod.nasa.gov/apod/apmilky+way.html

Which is not a valid page

Expected behavior
Either send me to just the landing page for apod, or fix this behaviour to search. The url params for searching on apod site do not work (maybe they changed it)

Additional context
Add any other context about the problem here.

Lenses in favour of Kagi Search bangs

Currently there are 166 Kagi Search bangs for kagi.com using site:[url] filters, such as /search?q={{{s}}}+site%3Atv.apple.com. These bangs can be replaced with Lenses, should they be removed?

Select a different provider for the `qr` bang

The qr bang to generate a QR code currently uses qrserver.com, which doesn't even have a homepage. I have zero reason to trust this entity to always faithfully represent the provided text as a QR code, without modifying any links to be malicious now or in the future. Please select a different QR code generator (ideally, one run by Kagi).

Hacker News

news.ycombinator.com

suggested shortcut: hn

Update Firefox Add-on Store Bangs

It would be significantly better to replace the URLs for the Firefox add-on store bangs with the following format: https://addons.mozilla.org/search/?q={{{s}}}.

Benefits:

  1. Localized Experience: This change ensures that the add-on store is displayed in the user's preferred language, enhancing accessibility and usability.

  2. Platform-Specific Searches: If the search is conducted on Android, this modification will direct users to the appropriate add-on store for Android, ensuring they find relevant extensions tailored to their device.

Action Required:

The URLs for the following bangs should be updated to https://addons.mozilla.org/search/?q={{{s}}}:

  • !amo
  • !fad
  • !ffa
  • !firefox
  • !mozaddon

Implementing this change will improve the overall user experience for Firefox add-on searches.

!trump bang

This is not a politically-motivated request, more in-keeping with Kagi's own bias avoidance, but I am not sure the !trump bang is really relevant for Kagi with these policies (and I'm kinda surprised it was even on DuckDuckGo in the first place).

For those unaware, it searches @realDonaldTrump's X/Twitter.

While this is a rather minor niggle (afterall, bangs are supposed to be crowdsourced), I only bring this up because I accidentally used it trying to use another bang after incorrectly selecting it with keyboard shourtcuts, and I can't be the only one slightly surprised that this is even a bang in the first place. Its also worth pointing out he no longer uses this profile (the last post being from 2023, and before that, 2021).

image

Kagi Feedback

Can I please request a search bang for the Kagi Feedback website at the domain kagifeedback.org? I searched in kagi_bangs.json and bangs.json, but I didn't see an existing bang for Kagi Feedback.

https://kagifeedback.org/

Tenor queries need to be encoded with `%20`, not `+`.

Describe the bug
Kagi encodes spaces in !tenor searches as +, and Tenor doesn't decode those back to spaces, so queries become malformed on Tenor's end.

image

image

To Reproduce
Steps to reproduce the behavior:

  1. Use the !tenor bang with a search term that includes spaces
  2. Observe that Tenor searches for the same term, but filled with plus signs
  3. Manually change the Tenor search to use spaces
  4. Observe that Tenor preserves the spaces, and also shows different results

Expected behavior
Tenor sees the search as having spaces

Additional context
This is not just an aesthetic concern. Tenor produces different search results with +- spaces vs actual-space-spaces.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.