{"id":29561511,"url":"https://github.com/official-imvoiid/winshell","last_synced_at":"2026-04-19T06:34:34.206Z","repository":{"id":305112857,"uuid":"1021958712","full_name":"official-imvoiid/WinShell","owner":"official-imvoiid","description":"Add/remove \"Open CMD\", \"PowerShell\", and \"Windows Terminal\" (regular \u0026 admin) context menu options in Windows 10/11. Includes registry backups and custom icons. MIT License. 🚀 ","archived":false,"fork":false,"pushed_at":"2025-07-18T08:20:50.000Z","size":171,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-18T12:17:04.107Z","etag":null,"topics":["batch","cmd","ico","mit-license","open-source","powershell","script","terminal","vbs","windows","windows-10","windows-11","windows-desktop"],"latest_commit_sha":null,"homepage":"","language":"Batchfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/official-imvoiid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-18T08:14:23.000Z","updated_at":"2025-07-18T08:34:53.000Z","dependencies_parsed_at":"2025-07-18T12:18:12.325Z","dependency_job_id":"2684e4af-4b28-492e-b036-8a37177952a0","html_url":"https://github.com/official-imvoiid/WinShell","commit_stats":null,"previous_names":["official-imvoiid/winshell"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/official-imvoiid/WinShell","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/official-imvoiid%2FWinShell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/official-imvoiid%2FWinShell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/official-imvoiid%2FWinShell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/official-imvoiid%2FWinShell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/official-imvoiid","download_url":"https://codeload.github.com/official-imvoiid/WinShell/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/official-imvoiid%2FWinShell/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268682669,"owners_count":24289681,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-04T02:00:09.867Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["batch","cmd","ico","mit-license","open-source","powershell","script","terminal","vbs","windows","windows-10","windows-11","windows-desktop"],"created_at":"2025-07-18T16:11:42.860Z","updated_at":"2026-04-19T06:34:34.170Z","avatar_url":"https://github.com/official-imvoiid.png","language":"Batchfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Terminal Context Menu Manager\n\n**Terminal Context Menu Manager** is a Windows utility that allows you to easily add or remove context menu options for opening **Command Prompt (CMD)**, **PowerShell**, and **Windows Terminal** (both regular and admin modes) in Windows 10 and Windows 11. These options appear when you right-click on folders, drives, or folder backgrounds in File Explorer, providing quick access to your preferred command-line tools.\n\n\u003e **⚠️ WARNING**: This program modifies the Windows Registry, which requires **administrator privileges**. Incorrect registry changes can cause **serious system issues**, potentially leading to catastrophic failures. While this program has been tested on Windows 10 and 11, and includes a registry backup feature, **proceed with caution**. Always ensure you have a backup before making changes.\n\n## Why This Program Was Created\n\nI primarily use **Kali Linux** as my main operating system for its robust terminal capabilities, but I rely on **Windows 10** for office-related tasks and other activities. After a recent update to Windows Terminal via `winget`, I noticed that the convenient \"Open Terminal here\" context menu option was missing. Despite trying various fixes—such as reinstalling Terminal, deleting configurations, and troubleshooting—the issue persisted. Frustrated, I decided to leverage my scripting skills to create a solution. This program not only restores the Windows Terminal context menu but also extends functionality by adding customizable context menu options for **CMD** and **PowerShell** (both regular and admin modes), providing a comprehensive tool for Windows users.\n\n## Prerequisites\n\n- **Windows 10 or Windows 11**: The program is compatible with both operating systems.\n- **Administrator Privileges**: Required to modify the Windows Registry.\n- **Command Prompt (CMD) and PowerShell**: These are built into all Windows installations by default.\n- **Windows Terminal**:\n  - **Windows 11**: Pre-installed by default.\n  - **Windows 10**: Must be installed via the Microsoft Store or using `winget` (e.g., `winget install Microsoft.WindowsTerminal`).\n- **Icon Files**: The program expects `cmd.ico`, `powershell.ico`, and `terminal.ico` to be present in the same directory as `TerminalContextMenu.bat` for custom context menu icons.\n- **VBS Scripts**: The scripts `OpenCmdAdmin.vbs`, `OpenPowerShellAdmin.vbs`, and `OpenTerminalAdmin.vbs` must be in the same directory as the batch file to enable admin-mode context menu options.\n\n## Important Notes\n\n- **Backup**: Before making any registry changes, the program creates a full registry backup in the `RegBackup` folder with a timestamped filename (e.g., `FullRegistry_YYYYMMDD_HHMMSS.reg`). This allows you to restore the registry if needed.\n- **File Location**: Place all files (`TerminalContextMenu.bat`, `.vbs` scripts, and `.ico` files) in a fixed directory (e.g., `C:\\Users\\username\\FolderName\\WinShell`). **Do not move the files after running the program**, as the registry entries reference the VBS scripts' paths. If you move the files, remove all context menu entries and re-run the program to re-add them.\n- **Windows Terminal**: If Windows Terminal is not installed, the program will still attempt to add its context menu entries using a default path or `wt.exe`. Ensure Terminal is installed for these options to work.\n\n## Directory Structure\n\nThe program expects the following files and folders in its directory:\n\n```\nC:\\Users\\voiid\\github\\WinShell\n│   cmd.ico                 # Icon for CMD context menu\n│   OpenCmdAdmin.vbs       # VBS script for CMD admin mode\n│   OpenPowerShellAdmin.vbs # VBS script for PowerShell admin mode\n│   OpenTerminalAdmin.vbs  # VBS script for Windows Terminal admin mode\n│   powershell.ico         # Icon for PowerShell context menu\n│   ReadMe.md              # This documentation file\n│   terminal.ico           # Icon for Windows Terminal context menu\n│   TerminalContextMenu.bat # Main batch script\n│\n├───RegBackup\n│       FullRegistry_YYYYMMDD_HHMMSS.reg # Registry backups\n│\n└───Screenshots\n        AddAll.png          # Screenshot of \"Add All\" menu\n        AddShellOptions.png # Screenshot of add options menu\n        MainScript.png      # Screenshot of main menu\n        OpenHere.png        # Screenshot of context menu in File Explorer\n        RemoveAll.png       # Screenshot of \"Remove All\" menu\n        RemoveShellOptions.png # Screenshot of remove options menu\n```\n\n## Program Details and Functions\n\n`TerminalContextMenu.bat` is a batch script that provides a user-friendly interface to manage context menu entries for CMD, PowerShell, and Windows Terminal. Below are the main features and functions:\n\n### Main Menu Options\n\n1. **Show System Information**:\n\n   - Displays system details, including:\n     - Username and computer name.\n     - Current and script directories.\n     - Paths to `cmd.exe`, `powershell.exe`, and `wt.exe` (if found).\n     - Status of icon files (`cmd.ico`, `powershell.ico`, `terminal.ico`).\n     - Status of VBS scripts (`OpenCmdAdmin.vbs`, `OpenPowerShellAdmin.vbs`, `OpenTerminalAdmin.vbs`).\n\n2. **Add Terminal Context Menu Options**:\n\n   - Adds context menu entries for:\n     - **CMD**: \"Open Command Prompt\" and \"Open Command Prompt (Admin)\".\n     - **PowerShell**: \"Open PowerShell\" and \"Open PowerShell (Admin)\".\n     - **Windows Terminal**: \"Open Terminal\" and \"Open Terminal (Admin)\".\n     - **All**: Adds all of the above.\n   - Entries are added for folders, folder backgrounds, and drives in File Explorer.\n   - Creates a registry backup before making changes.\n\n3. **Remove Terminal Context Menu Options**:\n\n   - Removes context menu entries for:\n     - **CMD**: Removes both regular and admin entries.\n     - **PowerShell**: Removes both regular and admin entries.\n     - **Windows Terminal**: Removes both regular and admin entries, including legacy `wt` entries.\n     - **All**: Removes all of the above.\n   - No registry backup is created for removal operations.\n\n4. **Exit**: Closes the program.\n\n### How It Works\n\n- **Registry Modifications**: The script modifies the Windows Registry under `HKEY_CLASSES_ROOT` to add or remove context menu entries for `Directory`, `Directory\\Background`, and `Drive`.\n- **Admin Privileges**: The script checks for admin rights and prompts for elevation if needed using a temporary VBS script.\n- **VBS Scripts**: Admin-mode context menu entries use VBS scripts to launch CMD, PowerShell, or Windows Terminal with elevated privileges and navigate to the selected directory.\n- **Icons**: Custom icons (`cmd.ico`, `powershell.ico`, `terminal.ico`) are referenced in the registry for a polished look.\n- **Error Handling**: The script checks for the presence of `cmd.exe`, `powershell.exe`, and `wt.exe`, and uses fallback paths if needed.\n\n### Screenshots\n\n- **MainScript.png**: Shows the main menu interface.\n- **AddShellOptions.png**: Displays the menu for adding context menu options.\n- **AddAll.png**: Shows the process of adding all context menu entries.\n- **RemoveShellOptions.png**: Displays the menu for removing context menu options.\n- **RemoveAll.png**: Shows the process of removing all context menu entries.\n- **OpenHere.png**: Demonstrates the context menu options in File Explorer.\n\n## Usage\n\n1. **Setup**:\n\n   - Download zip or git clone for the required files: `TerminalContextMenu.bat`, `OpenCmdAdmin.vbs`, `OpenPowerShellAdmin.vbs`, `OpenTerminalAdmin.vbs`, `cmd.ico`, `powershell.ico`, and `terminal.ico`.\n   - Place all files in a fixed directory (e.g., `C:\\Users\\voiid\\github\\WinShell`).\n   - Ensure Windows Terminal is installed on Windows 10 (not required for Windows 11).\n\n2. **Running the Program**:\n\n   - Click on `TerminalContextMenu.bat` and prompt **Yes** to **Run as administrator**.\n   - Follow the on-screen menu to:\n     - View system information.\n     - Add or remove context menu entries.\n     - Exit the program.\n\n3. **After Adding Entries**:\n\n   - Right-click on a folder, drive, or folder background in File Explorer to see the new \"Open Command Prompt\", \"Open PowerShell\", or \"Open Terminal\" options (regular and admin modes).\n\n4. **If You Move the Files**:\n\n   - Remove all context menu entries using the \"Remove All\" option.\n   - Move the files to the new location.\n   - Re-run `TerminalContextMenu.bat` as administrator to re-add the entries with updated paths.\n\n## Troubleshooting\n\n- **Context Menu Not Appearing**: Ensure the script was run as administrator and that the `.ico` and `.vbs` files are in the same directory as `TerminalContextMenu.bat`.\n- **Windows Terminal Options Not Working**: Verify that Windows Terminal is installed (Windows 10) and that `wt.exe` is accessible.\n- **Registry Issues**: If problems occur, restore the registry using the backup file in the `RegBackup` folder (double-click the `.reg` file and confirm).\n- **File Not Found Errors**: Check that all required files (`cmd.ico`, `powershell.ico`, `terminal.ico`, and VBS scripts) are present in the script directory.\n\n## License\n\nThis project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fofficial-imvoiid%2Fwinshell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fofficial-imvoiid%2Fwinshell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fofficial-imvoiid%2Fwinshell/lists"}