You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: web-search/README.md
+65-11Lines changed: 65 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,33 +7,87 @@ A launcher provider plugin that allows you to quickly search the internet direct
7
7
-**Quick Web Searching**: Search the web instantly without opening a browser first
8
8
-**Live Autocomplete**: Get search suggestions from your preferred engine as you type
9
9
-**Multiple Search Engines**: Support for Google, DuckDuckGo, Bing, Brave, and Yandex
10
+
-**Smart URL Detection**: Automatically detects URLs, IP addresses, and localhost and opens them directly in the browser
10
11
-**Smart Priorities**: Web search acts as a fallback when searching for apps, or takes absolute priority when using the explicit `>web` command
11
12
12
13
## Usage
13
14
14
15
1. Open the Noctalia launcher
15
-
2. Type `>web` to enter web search mode exclusively, OR just type your query directly into the launcher and scroll to the bottom to see web search fallbacks.
16
-
3. Your live suggestions will populate underneath the main result
17
-
4. Hit Enter to open the query in your default browser
16
+
2. Type `>web` followed by your query to enter web search mode exclusively
17
+
3. Or just type your query directly. Web search results appear as fallbacks below matched applications
18
+
4. Live suggestions populate underneath the main result as you type
19
+
5. Press Enter on any result to open it in your default browser
18
20
19
21
### Examples
20
22
21
-
```bash
22
-
# Explicitly search for recipes, bypassing all local files/apps
23
+
**Search with the `>web` command:**
24
+
```
23
25
>web chocolate cake recipe
26
+
```
27
+
This bypasses all local apps/files and shows only web search results. The top result will open a search for "chocolate cake recipe" in your configured engine, with autocomplete suggestions listed below.
24
28
25
-
# Search fallbacks (appears at bottom of launcher below matched applications)
29
+
**Fallback search:**
30
+
```
26
31
discord
27
32
```
33
+
Type a query normally. If it matches an installed app, the app appears first. Web search results appear at the bottom as fallbacks, so you can still search for "discord" on the web if the app isn't what you wanted.
34
+
35
+
**Direct URL navigation:**
36
+
```
37
+
>web github.com/noctalia-dev
38
+
```
39
+
When Direct URL Opening is enabled, the plugin detects that `github.com/noctalia-dev` is a URL and offers to open it directly in your browser, alongside the regular search result.
40
+
41
+
**Open localhost or IP addresses:**
42
+
```
43
+
>web localhost:3000
44
+
>web 192.168.1.1
45
+
```
46
+
Local addresses and IPs are detected as URLs and offered for direct opening. Localhost and IP addresses default to `http://`, while domain names default to `https://`.
47
+
48
+
## IPC Commands
49
+
50
+
You can control the web search plugin via the command line using the Noctalia IPC interface.
51
+
52
+
### Available Commands
53
+
54
+
| Command | Description | Example |
55
+
|---|---|---|
56
+
|`toggle`| Opens or closes the launcher on the current screen |`qs -c noctalia-shell ipc call plugin:web-search toggle`|
28
57
29
58
## Configuration
30
59
31
-
You can configure the plugin directly via Noctalia's Plugin API Settings:
32
-
-**Search Engine**: Choose between Google, DuckDuckGo, Bing, Brave, or Yandex
33
-
-**Show Search Suggestions**: Toggle whether to fetch real-time suggestions while typing
34
-
-**Maximum Results**: Control how many autocomplete suggestions appear in the launcher at once (1 to 10)
60
+
You can configure the plugin directly via Noctalia's Plugin Settings:
61
+
62
+
| Setting | Description | Default |
63
+
|---|---|---|
64
+
|**Search Engine**| Choose between Google, DuckDuckGo, Bing, Brave, or Yandex | Google |
65
+
|**Direct URL Opening**| Automatically detect URLs and open them directly in the browser instead of searching | Enabled |
0 commit comments