Skip to content

PowerToys Run Plugin for searching and opening GitHub repositories

License

Notifications You must be signed in to change notification settings

8LWXpg/PowerToysRun-GitHubRepo

Repository files navigation

GitHubRepo Plugin for PowerToys Run

This is a plugin for PowerToys Run that allows to search for GitHub repositories then open in your default browser.

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

Features

Search repo with query: query

Search repo with query

Search repo with user: user/repo

Search repo with user

Search repo with default user: /repo

If authtoken is set, it will list all the repositories the token has access to. Otherwise, it will list all the public repositories of the default user. Search repo with default user

Context menu

  • Open issues: Open the issues page of the repository Ctrl+I.
  • Open pull requests: Open the pull requests page of the repository Ctrl+P.
  • Copy link: Copy the repository link to clipboard Ctrl+C.

Settings

  • Default user: The default user to search for when typed /.
  • GitHub auth token (optional): The GitHub auth token to use for better rate limiting and access to private repo. You can generate a fine-grained token with read access to metadata. Detailed instructions here. token

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 GitHubRepo 8LWXpg/PowerToysRun-GitHubRepo

Usage

  1. Open PowerToys Run (default shortcut is Alt+Space).
  2. Type gr followed by your search query.
  3. Select a search result and press Enter to open it in browser.

Building

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

Debugging

  1. Clone the repository and the dependencies in /lib with GitHubRepo/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