GNOME Shell extension that surfaces a configurable web search provider in the Activities overview. Layout
extension/
├── extension.js # Extension entry point and search provider implementation
├── metadata.json # Extension metadata
└── schemas/
└── org.gnome.shell.extensions.search-provider-web.gschema.xml
The extension reads the following settings (modifiable with dconf or gsettings):
search-url– Template used to open queries. Include%swhere the encoded query should be substituted.provider-name– Label displayed in the overview for this provider.
Defaults use DuckDuckGo with the label "Web Search".
- Compile schemas in the extension directory:
glib-compile-schemas extension/schemas
- Copy the extension folder to your local GNOME Shell extensions directory (matching the UUID in
metadata.json):EXT_DIR="$HOME/.local/share/gnome-shell/extensions/web-search-provider@example.com" mkdir -p "$EXT_DIR" cp -r extension/* "$EXT_DIR" glib-compile-schemas "$EXT_DIR/schemas"
- Restart GNOME Shell (
Alt+F2, typer, press Enter) or log out and back in. - Enable the extension via GNOME Extensions or
gnome-extensions enable web-search-provider@example.com.
The project follows GNOME Shell extension guidelines by declaring supported shell versions, providing a unique UUID, bundling its schema, and avoiding blocking operations on the GNOME Shell main thread.