Update README.md

pull/2/head
ThioJoe 2025-08-04 20:56:19 -07:00
parent fd4a040d0e
commit 7fa557a7b9
No known key found for this signature in database
GPG Key ID: 2E328FE64CC3898C
1 changed files with 29 additions and 3 deletions

View File

@ -1,10 +1,36 @@
# Windows-Sandbox-Tools
# Scripts & Tools for Windows Sandbox
Various useful scripts for use within Windows Sandbox
## Installer Scripts
PowerShell scripts that can install apps or components not normally included in the Sandbox
- `Install-Winget.ps1`: Fetches necessary files and dependencies from Microsoft's [winget-cli](https://github.com/microsoft/winget-cli) repo, and installs it
- `Install-Microsoft-Store.ps1`: Installs the Microsoft Store via the Windows Update APIs
- Unlike other similar scripts, mine does NOT use any third party APIs like UUP Dump or RG-Adguard at all
- (All web requests go directly to Microsoft servers. Even those fetching the download URLs in the first place)
- `Install VC Redist.ps1`: Installs the latest Microsoft Visual C++ Redistributables, which are commonly required by other software.
---------
## Using `SandboxStartup.ps1`
The script is written assuming it will be run from _within_ the sandbox, so to automatically run it you'll need to put it into a mapped shared folder.
## SandboxStartup.ps1
This script runs within the Sandbox at launch and does a bunch of random registry tweaks to set up the Sandbox based on my own preference
Specifically:
- Enables the old context menu
- Enables Explorer settings: Show hidden files, Show file extensions
- Adds "Open PowerShell Here" and "Open CMD Here" options to the context menu
- Adds `.txt` and `.ps1` files to the Context Menu > "New" list
- Sets PowerShell execution policy to allow running scripts, and also makes them runnable by double clicking
- If you put Notepad or Notepad++ into the shared host folder (described in next section), it will add context menu options to Edit files with them, and set them as default editor for `.txt` files
- Finally restarts Explorer to apply any changes and opens the shared host folder
### How to Use `SandboxStartup.ps1`
It is written assuming it will be run from _within_ the sandbox, so to automatically run it you'll need to put it into a mapped shared folder.
1. Create some new folder location (not in the sandbox) which you'll map into the sandbox. It doesn't matter what it's called or where it goes, but maybe something like `C:\Users\WhateverUsername\MySharedSandboxFolder`
2. In this repo I have the [`MyDefaultSandbox.wsb`](Sandbox%20Configurations/MyDefaultSandbox.wsb) configuration file which is already set up to map the folder to the location the script expects. So in there you just need to update the `<HostFolder>` setting to use the path you selected in the previous step.