readme.md

UnpinApps

A light-weight Windows utility that automatically unpins apps on your taskbar at login.

Prerequisites

• Install PowerShell 7
  • winget install Microsoft.PowerShell
• Enable running PowerShell scripts on your PC (must be admin elevated)
  • Set-ExecutionPolicy RemoteSigned

Usage

Note that if you remove or move cloned directory after installation you'll need to run ~Install.bat again.

1. Clone this reposiotry.

   • git clone https://github.com/ninbura/UnpinApps.git

2. Enter the cloned directory.

   • cd UnpinApps

3. Create a Config.json file.

   • New-Item -Path Config.json -Type File 

4. Populate Config.json contents, as exampled below (configuration Example).
5. Right click and run ~Install.bat, ~RunManually.bat, or ~Uninstall.bat as admin.

Batch Scripts

• ~Install.bat - Creates scheduled tasks to unpin apps at login and after Explorer restarts.
• ~RunManually.bat - Manually runs the UnpinApps.ps1 script.
• ~Uninstall.bat - Removes the UnpinApps logon task if it exists.

Logging

Every time the UnpinApps.ps1 executes, details of your configuration, as well as the overall process are stored in the UnpinApps.log file at the root of the cloned directory. This can assist with troublshooting if results aren't as expected.

Configuration Example

For the script to run at login, you must place a properly formatted Config.json file in root of this repository/directory. Below is an example of what Config.json should contain.

{
  "UnpinApps": [
    "Company Portal",
    "Excel",
    "Google Chrome",
    "Microsoft Edge",
    "Outlook (classic)",
    "Outlook (new)",
    "Quick Assist",
    "Word"
  ]
}