78 lines
2.9 KiB
Plaintext
78 lines
2.9 KiB
Plaintext
---
|
|
tags:
|
|
- Search engines
|
|
- Google
|
|
- Search
|
|
---
|
|
|
|
# Search Engines
|
|
|
|
Using the search engines, terms can be quickly searched simply by opening the search bar at the top or using the keyboard shortcut `MOD + K`.
|
|
The management page provides a searchable list with the shortcut, URL template, source, and available row actions for each engine.
|
|
|
|
The default **Search** mode lists every configured search engine as a fallback action for the current query. To discover
|
|
engines by shortcut, switch to **Web** with `!`. DuckDuckGo bang discovery is intentionally limited to Web mode so an
|
|
ordinary search term never expands into similarly named bang providers.
|
|
|
|
|
|
|
|
You can add any search engine that has a search URL that accepts a search term as a parameter.
|
|
|
|
## Create search engine
|
|
|
|
To create a custom search engine, you can click the button at the top of the page.
|
|
|
|
|
|
|
|
### Name
|
|
|
|
The name can be chosen freely. It will be displayed in the search box popover.
|
|
|
|
### Short
|
|
|
|
Prefix that is used to choose the search engine in the popover using the keyboard.
|
|
It is recommended that this value is kept short (for example `g` for Google and `e` for Ecosia).
|
|
Type `!` in Spotlight to browse these shortcuts and, when DuckDuckGo bangs are enabled in preferences, discover
|
|
additional bang providers.
|
|
|
|
### Configuration
|
|
|
|
In the configuration section you can select between two options.
|
|
|
|
#### Search template
|
|
|
|
The template must be a valid URL that includes the `%s` placeholder.
|
|
Homarr will replace the `%s` with the term that the user entered.
|
|
|
|
##### Examples
|
|
|
|
- Google: `https://www.google.com/search?q=%s`
|
|
- Ecosia: `https://www.ecosia.org/search?q=%s`
|
|
- DuckDuckGo: `https://duckduckgo.com/?q=%s`
|
|
- Bing: `https://www.bing.com/search?q=%s`
|
|
- YouTube: `https://www.youtube.com/results?search_query=%s`
|
|
|
|
## Media request search
|
|
|
|
Jellyseerr, Overseerr, and Seerr integrations have a dedicated **Spotlight mode** for searching and requesting media.
|
|
This mode does not require creating a search engine entry - it is available automatically when you have a compatible integration configured.
|
|
|
|
You can access it from:
|
|
|
|
- The **Modes list** in Spotlight (opened with `CTRL + K`)
|
|
- The **search button** on the media request list and stats widgets
|
|
|
|
### Availability indicators
|
|
|
|
Search results display colored status badges showing the media's current state in your integration:
|
|
|
|
- **Available** - fully available in your media library
|
|
- **Partial** - some content (e.g. seasons) is available
|
|
- **Processing** - currently being downloaded or processed
|
|
- **Requested** - requested but not yet available
|
|
|
|
### Requesting TV show seasons
|
|
|
|
For partially available TV shows, you can request additional seasons.
|
|
The request modal shows which seasons are already requested (marked with a status badge and not selectable), so you can select only the missing seasons.
|