mirror of https://github.com/lissy93/dashy
📝 Adds docs for configuring web search
This commit is contained in:
parent
72e5cf2b46
commit
6422f21572
12
README.md
12
README.md
|
@ -327,6 +327,8 @@ You can change the view from the UI, using the switch icon in the top-right corn
|
||||||
|
|
||||||
## Searching and Shortcuts 🔎
|
## Searching and Shortcuts 🔎
|
||||||
|
|
||||||
|
> For full documentation on searching, see: [**Searching & Shortcuts**](./docs/searching.md)
|
||||||
|
|
||||||
Quickly finding and launching applications is the primary aim of Dashy. To that end instant search and customizable keyboard shortcuts are built-in.
|
Quickly finding and launching applications is the primary aim of Dashy. To that end instant search and customizable keyboard shortcuts are built-in.
|
||||||
|
|
||||||
To start filtering, just start typing. No need to select the search bar or use any special key. You can then use either the tab key or arrow keys to select and move between results, and hit enter to launch the currently selected application. You can also use `Alt + Enter` on a selected app to launch it in a popup modal, `Ctrl + Enter` to open in new tab, or right-click on it to see all opening methods.
|
To start filtering, just start typing. No need to select the search bar or use any special key. You can then use either the tab key or arrow keys to select and move between results, and hit enter to launch the currently selected application. You can also use `Alt + Enter` on a selected app to launch it in a popup modal, `Ctrl + Enter` to open in new tab, or right-click on it to see all opening methods.
|
||||||
|
@ -353,6 +355,16 @@ Example:
|
||||||
hotkey: 8
|
hotkey: 8
|
||||||
```
|
```
|
||||||
|
|
||||||
|
To search the web directly through Dashy, just press enter after typing your query. Options for web search are set under `appConfig.webSearch`. There is built in support for [10+ search engines](./docs/searching.md#setting-search-engine), or [use your own custom provider](./docs/searching.md#using-custom-search-engine) or self-hosted instance.
|
||||||
|
To disable web search all together, set: `webSearch: { disableWebSearch: true }`
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
appConfig:
|
||||||
|
webSearch:
|
||||||
|
searchEngine: duckduckgo
|
||||||
|
openingMethod: newtab
|
||||||
|
```
|
||||||
|
|
||||||
Hit `Esc` at anytime to close any open apps, clear the search field, or hide any modals.
|
Hit `Esc` at anytime to close any open apps, clear the search field, or hide any modals.
|
||||||
|
|
||||||
**[⬆️ Back to Top](#dashy)**
|
**[⬆️ Back to Top](#dashy)**
|
||||||
|
|
|
@ -1,82 +1,82 @@
|
||||||
# Keyboard Shortcuts
|
# Keyboard Shortcuts
|
||||||
|
|
||||||
## Searching
|
## Searching
|
||||||
One of the primary purposes of Dashy is to allow you to quickly find and launch a given app. To make this as quick as possible, there is no need to touch the mouse, or press a certain key to begin searching - just start typing. Results will be filtered in real-time. No need to worry about case, special characters or small typos, these are taken care of, and your results should appear.
|
One of the primary purposes of Dashy is to allow you to quickly find and launch a given app. To make this as quick as possible, there is no need to touch the mouse, or press a certain key to begin searching - just start typing. Results will be filtered in real-time. No need to worry about case, special characters or small typos, these are taken care of, and your results should appear.
|
||||||
|
|
||||||
## Navigating
|
## Navigating
|
||||||
You can navigate through your items or search results using the keyboard. You can use <kbd>Tab</kbd> to cycle through results, and <kbd>Shift</kbd> + <kbd>Tab</kbd> to go backwards. Or use the arrow keys, <kbd>↑</kbd>, <kbd>→</kbd>, <kbd>↓</kbd> and <kbd>←</kbd>.
|
You can navigate through your items or search results using the keyboard. You can use <kbd>Tab</kbd> to cycle through results, and <kbd>Shift</kbd> + <kbd>Tab</kbd> to go backwards. Or use the arrow keys, <kbd>↑</kbd>, <kbd>→</kbd>, <kbd>↓</kbd> and <kbd>←</kbd>.
|
||||||
|
|
||||||
## Launching Apps
|
## Launching Apps
|
||||||
You can launch a elected app by hitting <kbd>Enter</kbd>. This will open the app using your default opening method, specified in `target` (either `newtab`, `sametab`, `modal` or `workspace`). You can also use <kbd>Alt</kbd> + <kbd>Enter</kbd> to open the app in a pop-up modal, or <kbd>Ctrl</kbd> + <kbd>Enter</kbd> to open it in a new tab. For all available opening methods, just right-click on an item, to bring up the context menu.
|
You can launch a elected app by hitting <kbd>Enter</kbd>. This will open the app using your default opening method, specified in `target` (either `newtab`, `sametab`, `modal` or `workspace`). You can also use <kbd>Alt</kbd> + <kbd>Enter</kbd> to open the app in a pop-up modal, or <kbd>Ctrl</kbd> + <kbd>Enter</kbd> to open it in a new tab. For all available opening methods, just right-click on an item, to bring up the context menu.
|
||||||
|
|
||||||
## Tags
|
## Tags
|
||||||
By default, items are filtered by the `title` attribute, as well as the hostname (extracted from `url`), the `provider` and `description`. If you need to find results based on text which isn't included in these attributes, then you can add `tags` to a given item.
|
By default, items are filtered by the `title` attribute, as well as the hostname (extracted from `url`), the `provider` and `description`. If you need to find results based on text which isn't included in these attributes, then you can add `tags` to a given item.
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
items:
|
items:
|
||||||
- title: Plex
|
- title: Plex
|
||||||
description: Media library
|
description: Media library
|
||||||
icon: favicon
|
icon: favicon
|
||||||
url: https://plex.lab.local
|
url: https://plex.lab.local
|
||||||
tags: [ movies, videos, music ]
|
tags: [ movies, videos, music ]
|
||||||
- title: FreshRSS
|
- title: FreshRSS
|
||||||
description: RSS Reader
|
description: RSS Reader
|
||||||
icon: favicon
|
icon: favicon
|
||||||
url: https://freshrss.lab.local
|
url: https://freshrss.lab.local
|
||||||
tags: [ news, updates, blogs ]
|
tags: [ news, updates, blogs ]
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
In the above example, Plex will be visible when searching for 'movies', and FreshRSS with 'news'
|
In the above example, Plex will be visible when searching for 'movies', and FreshRSS with 'news'
|
||||||
|
|
||||||
|
|
||||||
## Custom Hotkeys
|
## Custom Hotkeys
|
||||||
For apps that you use regularly, you can set a custom keybinding. Use the `hotkey` parameter on a certain item to specify a numeric key, between `0 - 9`. You can then launch that app, by just pressing that key, which is much quicker than searching for it, if it's an app you use frequently.
|
For apps that you use regularly, you can set a custom keybinding. Use the `hotkey` parameter on a certain item to specify a numeric key, between `0 - 9`. You can then launch that app, by just pressing that key, which is much quicker than searching for it, if it's an app you use frequently.
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
- title: Bookstack
|
- title: Bookstack
|
||||||
icon: far fa-books
|
icon: far fa-books
|
||||||
url: https://bookstack.lab.local/
|
url: https://bookstack.lab.local/
|
||||||
hotkey: 2
|
hotkey: 2
|
||||||
- title: Git Tea
|
- title: Git Tea
|
||||||
icon: fab fa-git
|
icon: fab fa-git
|
||||||
url: https://git.lab.local/
|
url: https://git.lab.local/
|
||||||
target: workspace
|
target: workspace
|
||||||
hotkey: 3
|
hotkey: 3
|
||||||
```
|
```
|
||||||
|
|
||||||
In the above example, pressing <kbd>2</kbd> will launch Bookstack. Or hitting <kbd>3</kbd> will open Git in the workspace view.
|
In the above example, pressing <kbd>2</kbd> will launch Bookstack. Or hitting <kbd>3</kbd> will open Git in the workspace view.
|
||||||
|
|
||||||
## Web Search
|
## Web Search
|
||||||
It's possible to search the web directly from Dashy, which might be useful if you're using Dashy as your start page. This can be done by pressing <kbd>⏎</kbd> after typing your query into the search bar. Web search options are configured under `appConfig.webSearch`.
|
It's possible to search the web directly from Dashy, which might be useful if you're using Dashy as your start page. This can be done by typing your query as normal, and then pressing <kbd>⏎</kbd>. Web search options are configured under `appConfig.webSearch`.
|
||||||
|
|
||||||
#### Setting Search Engine
|
#### Setting Search Engine
|
||||||
By default, DuckDuckGo is used as the search engine, but you can change this by setting `webSearch.searchEngine` to the key of your favorite search provider. Currently supported providers:
|
Set your default search engine using the `webSearch.searchEngine` property. This defaults to DuckDuckGo. Search engine must be referenced by their key, the following providers are supported:
|
||||||
- Main: `duckduckgo`, `google`, `whoogle`, `qwant`, `startpage`, `searx-bar`, `searx-info`
|
- `duckduckgo`, `google`, `whoogle`, `qwant`, `startpage`, `searx-bar`, `searx-info`
|
||||||
- Nice: `searx-tiekoetter`, `searx-bissisoft`, `ecosia`, `metager`, `swisscows`, `mojeek`, `peekier`
|
- `searx-tiekoetter`, `searx-bissisoft`, `ecosia`, `metager`, `swisscows`, `mojeek`, `peekier`
|
||||||
- Specific: `wikipedia`, `wolframalpha`, `stackoverflow`, `github`, `reddit`, `youtube`, `bbc`
|
- `wikipedia`, `wolframalpha`, `stackoverflow`, `github`, `reddit`, `youtube`, `bbc`
|
||||||
|
|
||||||
#### Using Custom Search Engine
|
#### Using Custom Search Engine
|
||||||
If you're self-hosting your own search engine (like [Whoogle](https://github.com/benbusby/whoogle-search) or [Searx](https://searx.github.io/searx/)) or you'd like to use a provider not included in this list, then just set `searchEngine: custom` and put the URL of your engine, along with the GET parameter for query string, into `customSearchEngine`
|
You can also use a custom search engine, that isn't included in the above list (like a self-hosted instance of [Whoogle](https://github.com/benbusby/whoogle-search) or [Searx](https://searx.github.io/searx/)). Set `searchEngine: custom`, and then specify the URL (plus query params) to you're search engine under `customSearchEngine`.
|
||||||
|
|
||||||
#### Setting Opening Method
|
For example:
|
||||||
By default, results are opened in a new tab, but `sametab`, `newtab` and `workspace` are all supported
|
```yaml
|
||||||
|
appConfig:
|
||||||
#### Disabling Web Search
|
webSearch:
|
||||||
Web search can be disabled, by setting `disableWebSearch: true`
|
searchEngine: custom
|
||||||
|
customSearchEngine: 'https://searx.local/search?q='
|
||||||
|
```
|
||||||
```yaml
|
|
||||||
appConfig:
|
#### Setting Opening Method
|
||||||
theme: dashy-docs
|
In a similar way to opening apps, you can specify where you would like search results to be opened. This is done under the `openingMethod` attribute, and can be set to either `newtab`, `sametab` or `workspace`. By default results are opened in a new tab.
|
||||||
webSearch:
|
|
||||||
disableWebSearch: false
|
#### Disabling Web Search
|
||||||
searchEngine: 'duckduckgo'
|
Web search can be disabled, by setting `disableWebSearch`, for example:
|
||||||
customSearchEngine: ''
|
|
||||||
openingMethod: 'newtab'
|
```yaml
|
||||||
```
|
appConfig:
|
||||||
|
webSearch: { disableWebSearch: true }
|
||||||
|
```
|
||||||
## Clearing Search
|
|
||||||
You can clear your search term at any time, by pressing <kbd>Esc</kbd>.
|
## Clearing Search
|
||||||
This can also be used to close an open pop-up modal.
|
You can clear your search term at any time, resting the UI to it's initial state, by pressing <kbd>Esc</kbd>. This can also be used to close any open pop-up modals.
|
||||||
|
|
Loading…
Reference in New Issue