Skip to content

8LWXpg/PowerToysRun-SSH

Repository files navigation

SSH Plugin for PowerToys Run

A PowerToys Run plugin for connecting to SSH clients that configured at ~/.ssh/config file.

Checkout the Template for a starting point to create your own plugin.

Note

Different terminals might behave different on open mode.

Features

Open SSH connection

screenshot

Installation

Manual

  1. Download the latest release of the from the releases page.
  2. Extract the zip file's contents to %LocalAppData%\Microsoft\PowerToys\PowerToys Run\Plugins
  3. Restart PowerToys.

Via ptr

ptr add SSH 8LWXpg/PowerToysRun-SSH

Usage

  1. Open PowerToys Run (default shortcut is Alt+Space).
  2. Type ssh.

Building

  1. Clone the repository and the dependencies in /lib with SSH/copyLib.ps1.
  2. run dotnet build -c Release.

Debugging

  1. Clone the repository and the dependencies in /lib with SSH/copyLib.ps1.
  2. Build the project in Debug configuration.
  3. Make sure you have gsudo installed in the path.
  4. Run debug.ps1 (change $ptPath if you have PowerToys installed in a different location).
  5. Attach to the PowerToys.PowerLauncher process in Visual Studio.

Contributing

Localization

If you want to help localize this plugin, please check the localization guide

Support other Terminal

Check CONTRIBUTING.md