Skip to content

Daydreamer-riri/CmdPal-WebSearchShortcut

Repository files navigation

CmdPal-WebSearchShortcut

Mentioned in Awesome PowerToys Run Plugins

Microsoft

This is a simple PowerToys CmdPal plugin for quickly selecting a specific search engine to perform searches via keyword prefixes.

If you are looking for the Powertoys Run plugin, please check: WebSearchShortcut run plugin

Preview

Preview of the plugin in action

Installation

MSStore

Click the badge below to go to the store page:

Microsoft

WinGet

winget install Riri.WebSearchShortcut

MSIX Files

You can download the MSIX files from the Releases page on GitHub. Choose the appropriate file for your architecture (x64(more common) or ARM) and install it manually.

Configuration

  • Access the command shown in the image:

Open the configuration"

  • Complete the form's content and save it.

Configuration fields

Url

The URL template for performing the search. Use %s as a placeholder for the search query. If the URL does not contain %s, the URL will be opened directly when you press enter.

{
  "Google": {
    "Url": "https://www.google.com/search?q=%s"
  }
}

More example: https://github.com/Daydreamer-riri/PowerToys-Run-WebSearchShortcut/blob/main/README-Run.md#example

ReplaceWhitespace

With ReplaceWhitespace, you can specify which character(s) to replace a space with when performing a search. This is useful for some websites, such as Wikipedia, which don't use plus signs ("+") to separate words in the URL.

Value Result
"" (Default) Example+search
"+" Example+search
"%20" Example%20search
"-" Example-search
"_" Example_search

Note: The character defined in ReplaceWhitespace will be used literally as the separator without further encoding. While some modern browsers may automatically encode invalid characters, users are responsible for ensuring their chosen character is valid and compatible with the target URL template. For more information on valid URL characters, please refer to percent-encoding.

SuggestionProvider

Used to set the search suggestion provider.

The currently supported search suggestion providers are:

  • Google
  • Bing
  • npm
  • CanIUse

Planned:

  • DuckDuckGo
  • Yandex
  • Baidu
  • Youtube
  • Wiki

PRs welcome!

You can also set a Provider to another search engine. For example:

add-suggestions

Credits

  • This project can only be completed under the guidance of this article. Thanks to @hlaueriksson for his great work.

  • The search suggestion feature of this project is based on the relevant implementation of FlowLauncher, thanks @Flow-Launcher!

Thanks

Thank you to @thatgaypigeon for writing the excellent documentation! Thank you to @Tortoise for making many very useful refactorings and improvements to this project!

License

MIT License © 2023 Riri

Packages

 
 
 

Contributors