Degoog Bangs and commands

The syntax

A bang is ! followed by a trigger word. Degoog accepts it at either end of your query, so both of these are the same thing:

!weather london
weather london !weather

The leading form takes everything after the trigger as the argument. The trailing form takes everything before it. Triggers are case-insensitive, so !IP and !ip both work.

Not sure what you have? Type !help. It lists every command your instance can currently run, grouped into Built-in, Plugins, and Engine shortcuts, with a search box on top. Commands that are disabled or still missing required configuration are left out, so what you see is what will actually work.

The four built-in commands

There are also two built-in panels that are not commands and appear on their own: At a glance pulls a readable excerpt from the top result and shows it above your results, and Wikipedia puts a summary card in the sidebar when your query matches an article. Both can be turned off or configured in Settings, Plugins. Wikipedia can be pointed at any *.wikipedia.org domain, so fr.wikipedia.org works if you would rather read French.

Engine shortcuts

An engine can claim its own bang. When it does, that bang runs your search against only that engine. Google's is !g, so:

!g why is my dns broken

searches Google alone, skipping everything else you have enabled. Which shortcuts exist depends entirely on which engines you installed. !help lists them all under "Engine shortcuts".

Natural language mode

Some commands recognise plain phrases as well as bangs. !ip knows "what's my ip" and "my ip". !speedtest knows "speed test" and "test my internet speed". Store plugins add their own: "what's the weather", "what time is it in", "qr code for", and so on.

This is off by default. Each command that supports it gets a Natural language toggle in Settings, Plugins, Configure. Turn it on and typing the phrase without a ! runs the command and shows your normal search results underneath it, so you do not lose the search by asking a question.

Aliases

Aliases are extra names for a command you already have. Many store plugins ship with their own (!jf for !jellyfin, !pw for !password, !def for !define), and you can add as many of your own as you like.

Create data/aliases.json, or point DEGOOG_ALIASES_FILE somewhere else, and map new names to existing triggers:

{
  "jelly": "jellyfin",
  "search": "meili",
  "id": "uuid"
}

The key is what you type after !; the value is the command it runs. Restart the server to pick up changes. Aliases cannot shadow an existing trigger, so you will not accidentally break !help. Your aliases show up in !help next to the command they point at.

Commands from the Store

The official extensions repository adds a good number of these. A sample of what is there:

Browse the full catalogue in Settings, Store, or in the community extensions list.