Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/8LWXpg/PowerToysRun-PluginTemplate

Template for PowerToysRun Plugin in Visual Studio
https://github.com/8LWXpg/PowerToysRun-PluginTemplate

powertoys powertoys-run powertoys-run-plugin visual-studio visual-studio-template

Last synced: 29 days ago
JSON representation

Template for PowerToysRun Plugin in Visual Studio

Awesome Lists containing this project

README

        

![title image](https://github.com/8LWXpg/PowerToysRun-PluginTemplate/assets/105704427/0a6476f8-91b0-4245-be5b-9ec51f4a6a76)

# 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](https://github.com/8LWXpg/PowerToysRun-ProcessKiller).

## Template structure

```plaintext
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](https://learn.microsoft.com/en-us/visualstudio/ide/template-parameters?view=vs-2022)
- [Template schema reference](https://learn.microsoft.com/en-us/visualstudio/extensibility/visual-studio-template-schema-reference?view=vs-2022)
- [Template tags](https://learn.microsoft.com/en-us/visualstudio/ide/template-tags?view=vs-2022)