PowerToysRun Plugin Template

This is a template for Visual Studio to create a PowerToys Run plugin.

How to use

1. Download the latest release.
2. Move the zip to ~\Documents\Visual Studio 2022\Templates\ProjectTemplates.
3. Open Visual Studio 2022 and select the template named PowerToys Run Plugin Template.
4. Copy .dll from the PowerToys Run folder to .\Lib (using symlink or running copyLib.ps1 is recommended).
   • PowerToys.Common.UI.dll
   • PowerToys.ManagedCommon.dll
   • PowerToys.Settings.UI.Lib.dll
   • Wox.Infrastructure.dll
   • Wox.Plugin.dll
5. Follow TODOs in Main.cs.

Scripts

• copyLib.ps1 - copy dependencies.
• debug.ps1 - move debug files to destination.
• release.ps1 - create release on github with github cli.

How to debug

1. Build the project.
2. Run debug.ps1.
3. Attach to the process PowerToys.PowerLauncher.

Demo

Check ProcessKiller.

Template structure

MyPlugin
│   MyPlugin.sln
└───MyPlugin
    │   copyLib.ps1
    │   debug.ps1
    │   .editorconfig
    │   MyPlugin.csproj
    │   Main.cs
    │   plugin.json
    │   README.md
    │   release.ps1
    ├───Images
    │       Icon.dark.png
    │       Icon.light.png
    ├───Lib
    └───Properties
            Resources.Designer.cs
            Resources.resx

Update the template

Visual Studio 2022 caches the templates, so you can't simply replace the zip file.

1. Remove previous versions of the template.
2. Start Visual Studio 2022 then select Create a new project, this loads the templates.
3. Close Visual Studio 2022 or click Back.
4. Move the new zip to ~\Documents\Visual Studio 2022\Templates\ProjectTemplates.

Help improve this template

If you have any suggestions or improvements, feel free to open an issue or a pull request.

Useful links

• Template parameters
• Template schema reference
• Template tags