https://github.com/lextm/windowsterminal-shell

Install/uninstall scripts for Windows Terminal context menu items
https://github.com/lextm/windowsterminal-shell

Last synced: 29 days ago
JSON representation

Install/uninstall scripts for Windows Terminal context menu items

• Host: GitHub
• URL: https://github.com/lextm/windowsterminal-shell
• Owner: lextm
• License: mit
• Created: 2020-05-05T22:51:22.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-05-08T01:41:44.000Z (6 months ago)
• Last Synced: 2024-10-02T20:23:27.608Z (about 1 month ago)
• Language: PowerShell
• Homepage:
• Size: 171 KB
• Stars: 1,664
• Watchers: 16
• Forks: 149
• Open Issues: 15
• Metadata Files:
  • Readme: Readme.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# PowerShell Scripts to Install/Uninstall Context Menu Items for Windows Terminal

*A project backed by [LeXtudio Inc.](https://www.lextudio.com)*

## Install

1. [Install Windows Terminal](https://github.com/microsoft/terminal).

1. [Install PowerShell 7](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-core-on-windows?view=powershell-7).

1. Launch PowerShell 7 console as administrator, and run `install.ps1` to install context menu items to Windows Explorer.

   > Quickest way to run the latest script from GitHub at an elevated PowerShell 7 console is

   > ``` powershell

   > Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/lextm/windowsterminal-shell/master/install.ps1'))

   > ```

Now the menu items are added to Windows Explorer context menu.

![default layout](default.png)

Figure 1: Default layout

> The menu items are organized in the `default` layout. Other layouts such as `mini` and `flat` give different look and feel. To apply an alternative layout (like `mini`), simply run `install.ps1 mini`.

![flat layout](flat.png)

Figure 2: Flat layout

![mini layout](mini.png)

Figure 3: Mini layout

## Uninstall

1. Run `uninstall.ps1` to uninstall context menu items from Windows Explorer.

> To uninstall an alternative layout (like `mini`), run `uninstall.ps1 mini`.

## Notes

The current release only supports Windows 10 machines (Windows Terminal restriction) and Windows Terminal installed via the store or .appx file.

> If Windows Terminal is installed via Scoop, [scripts from another repo](https://github.com/grimux/windowsterminal-shell-scoop/tree/scoop-support) might help.

The install script must be run as administrator.

> That's because it pulls out data from Windows Terminal's installation folder, which is locked down by Windows 10.

PowerShell 7 installed from Microsoft Store is not supported by the scripts (more details can be found in [#37](https://github.com/lextm/windowsterminal-shell/issues/37)).

`install.ps1` and `uninstall.ps1` only manipulate current user's Windows Explorer settings for the context menu items, and do not write to Windows Terminal settings.

> So different users on the same machine must install the context menu items separately, but possibly with different layouts.

Downloading Windows Terminal icon from GitHub (in `install.ps1`) requires internet connection, but in general is just an optional step that won't be executed in most cases.

## More Products

To learn more about other cool products from LeXtudio Inc. , please visit [our homepage](https://www.lextudio.com/#projects).