From 64252192fa6852988a3aa2448cc6a7e2a5d8123a Mon Sep 17 00:00:00 2001 From: Davide Giacometti Date: Tue, 8 Aug 2023 14:01:50 +0200 Subject: [PATCH] [Run][PluginManager]Doc for 3rd party plugins (#27566) * doc for 3rd party run plugins * link 3rd party run plugins doc * fix spellcheck * remove file * fix links * added author * Update doc/thirdPartyRunPlugins.md Co-authored-by: Nathan Driver <80888259+NathanD-GDS@users.noreply.github.com> * Update doc/thirdPartyRunPlugins.md Co-authored-by: Nathan Driver <80888259+NathanD-GDS@users.noreply.github.com> * Update doc/thirdPartyRunPlugins.md Co-authored-by: Nathan Driver <80888259+NathanD-GDS@users.noreply.github.com> * Update doc/thirdPartyRunPlugins.md Co-authored-by: Nathan Driver <80888259+NathanD-GDS@users.noreply.github.com> * Update doc/thirdPartyRunPlugins.md Co-authored-by: Nathan Driver <80888259+NathanD-GDS@users.noreply.github.com> * Update doc/thirdPartyRunPlugins.md Co-authored-by: Nathan Driver <80888259+NathanD-GDS@users.noreply.github.com> --------- Co-authored-by: Nathan Driver <80888259+NathanD-GDS@users.noreply.github.com> --- .github/actions/spell-check/expect.txt | 10 ++++++ README.md | 4 +++ doc/thirdPartyRunPlugins.md | 35 +++++++++++++++++++ .../SettingsXAML/Views/PowerLauncherPage.xaml | 18 +++++++--- .../Settings.UI/Strings/en-us/Resources.resw | 12 +++++-- 5 files changed, 72 insertions(+), 7 deletions(-) create mode 100644 doc/thirdPartyRunPlugins.md diff --git a/.github/actions/spell-check/expect.txt b/.github/actions/spell-check/expect.txt index bcd12d6775..f1a9bc0347 100644 --- a/.github/actions/spell-check/expect.txt +++ b/.github/actions/spell-check/expect.txt @@ -155,6 +155,7 @@ BOKMAL bootstrapper BOOTSTRAPPERINSTALLFOLDER Bopomofo +bostrot BOTTOMALIGN BPBF bpmf @@ -605,6 +606,7 @@ FZE gabime GAC gacutil +Galaxi Gaeilge Gaidhlig GBarm @@ -617,6 +619,7 @@ gcode gdi gdiplus GDISCALED +GEmoji GETDESKWALLPAPER GETDLGCODE GETDPISCALEDSIZE @@ -705,6 +708,7 @@ HKL HKLM HKPD HKU +hlaueriksson HLOCAL HMD hmenu @@ -1474,6 +1478,7 @@ ptc ptd PTOKEN PToy +ptrun ptstr pui PULONG @@ -1518,6 +1523,7 @@ RCtrl READMODE READOBJECTS READWRITE +recents RECTDESTINATION RECTL rectp @@ -1748,6 +1754,7 @@ SIZENWSE sizeread SIZEWE SKIPOWNPROCESS +skttl sku SLGP sln @@ -1881,6 +1888,7 @@ taskbar taskkill tasklist taskschd +TBM tchar Tcollab tcp @@ -2234,12 +2242,14 @@ XStr XUP XVIRTUALSCREEN YAxis +ycv Yeet YIncrement yinle yinwang yinyue YOffset +Youdao YPels YResolution YStr diff --git a/README.md b/README.md index 88c0ba9961..cab666b120 100644 --- a/README.md +++ b/README.md @@ -76,6 +76,10 @@ winget install --scope machine Microsoft.PowerToys -s winget There are [community driven install methods](./doc/unofficialInstallMethods.md) such as Chocolatey and Scoop. If these are your preferred install solutions, you can find the install instructions there. +## Third-Party Run Plugins + +Collection of [third-party plugins](./doc/thirdPartyRunPlugins.md) created by the community that aren't distributed with PowerToys. + ## Contributing This project welcomes contributions of all types. Help spec'ing, design, documentation, finding bugs are ways everyone can help on top of coding features / bug fixes. We are excited to work with the power user community to build a set of tools for helping you get the most out of Windows. diff --git a/doc/thirdPartyRunPlugins.md b/doc/thirdPartyRunPlugins.md new file mode 100644 index 0000000000..ed0f62acb5 --- /dev/null +++ b/doc/thirdPartyRunPlugins.md @@ -0,0 +1,35 @@ +# Third-Party plugins for PowerToy Run + +This is a collection of third-party plugins for PowerToys Run created by the community. + +## Installing and upgrading third-party PowerToys Run plugins + +The recommended path for the plugins is `%LOCALAPPDATA%\Microsoft\PowerToys\PowerToys Run\Plugins`. + +1. Close PowerToys. +1. Copy the plugin folder to `%LOCALAPPDATA%\Microsoft\PowerToys\PowerToys Run\Plugins`. +1. If you're upgrading a plugin, delete the previous version. +1. Open PowerToys. + +Refer to plugin instruction for more details. + +## Disclaimer + +The following plugins are created and maintained by third-party and not officially supported or recognized by Microsoft. +Users install and use these plugins at their own risk, and Microsoft takes no responsibility for their functionality or any potential issues they may cause. +Contact the developers of a plugin directly for assistance with a specific plugin. + +## Plugins + +| Plugin | Author | Description | +| ------ | ------ | ----------- | +| [BrowserSearch](https://github.com/TBM13/BrowserSearch) | [TBM13](https://github.com/TBM13) | Search your browser history | +| [Edge Favorite](https://github.com/davidegiacometti/PowerToys-Run-EdgeFavorite) | [davidegiacometti](https://github.com/davidegiacometti) | Open Microsoft Edge favorites | +| [Everything](https://github.com/lin-ycv/EverythingPowerToys) | [Yu Chieh (Victor) Lin](https://github.com/Lin-ycv) | Get search results from Everything | +| [GitHub Emoji](https://github.com/hlaueriksson/GEmojiSharp) | [hlaueriksson](https://github.com/hlaueriksson) | Search GitHub Emoji | +| [GitKraken](https://github.com/davidegiacometti/PowerToys-Run-GitKraken) | [davidegiacometti](https://github.com/davidegiacometti) | Open GitKraken repositories | +| [Guid](https://github.com/skttl/ptrun-guid) | [skttl](https://github.com/skttl) | Guid generator | +| [PowerTranslator](https://github.com/N0I0C0K/PowerTranslator) | [N0I0C0K](https://github.com/N0I0C0K) | Text translator based on Youdao | +| [Quick Lookup](https://github.com/GTGalaxi/quick-lookup-ptrun) | [gtgalaxi](https://github.com/GTGalaxi) | Search across multiple cyber security tools | +| [Visual Studio](https://github.com/davidegiacometti/PowerToys-Run-VisualStudio) | [davidegiacometti](https://github.com/davidegiacometti) | Open Visual Studio recents | +| [WinGet](https://github.com/bostrot/PowerToysRunPluginWinget) | [bostrot](https://github.com/bostrot) | Search and install packages from WinGet | diff --git a/src/settings-ui/Settings.UI/SettingsXAML/Views/PowerLauncherPage.xaml b/src/settings-ui/Settings.UI/SettingsXAML/Views/PowerLauncherPage.xaml index 33e3255341..9eaa02f9c2 100644 --- a/src/settings-ui/Settings.UI/SettingsXAML/Views/PowerLauncherPage.xaml +++ b/src/settings-ui/Settings.UI/SettingsXAML/Views/PowerLauncherPage.xaml @@ -269,10 +269,17 @@ - + + + + + + + + Enable at least one plugin to get started - + Plugins - + Include or remove plugins from the global results, change the direct activation phrase and configure additional options @@ -3593,4 +3593,10 @@ Activate by holding the key for the character you want to add an accent to, then Automatically hide crosshairs when the mouse pointer is hidden - + + Find more plugins + + + Find more plugins + + \ No newline at end of file