Skip to content
KnifMelti edited this page Jan 9, 2026 · 5 revisions

General

What is Windows Sandbox?

A lightweight desktop environment for safely running applications in isolation. When you close the sandbox, everything inside is deleted.

Why do I need Pro/Enterprise/Education?

Windows Sandbox is only available in these editions. Windows Home doesn't support it.

Can I use this on Windows Home?

No, you need to upgrade to Pro, Enterprise, or Education.

Is it safe to test malware?

Windows Sandbox provides isolation, but it's not designed for malware analysis. Use dedicated tools like FLARE-VM for serious malware research.

What happens to files in the sandbox?

Everything is deleted when you close the sandbox. Only the mapped folder can be modified (if not read-only).

Can I save files from the sandbox?

Yes, save them to the mapped folder on the desktop. Everything else is deleted when the sandbox closes.

Features

Why is AutoInstall special?

It always installs first, before any selected package list. Useful for tools you need in every session.

How do I find WinGet package IDs?

winget search "app name"

Or browse: https://github.com/microsoft/winget-pkgs/tree/master/manifests

Can I use this offline?

Partially:

  • Disable networking to test offline installers
  • WinGet features won't work without internet
  • Scripts and folder mapping still work

What are the startup time differences?

  • Empty WSB: ~15 seconds
  • Full Offline mode: ~25-30 seconds
  • Network-Only mode: ~25-30 seconds
  • Full Install (with WinGet): ~45 seconds

How do I customize default scripts?

Add # CUSTOM OVERRIDE as the first line of any Std-*.ps1 file to protect it from GitHub updates.

How does GitHub sync work?

Default scripts and package lists (Std-.ps1, Std-.txt) are auto-downloaded from GitHub. Files with # CUSTOM OVERRIDE are skipped.

Package Lists

Where do I put package lists?

In the wsb\ folder as .txt files with WinGet package IDs (one per line).

Can I delete Std-* lists?

Yes, select and press Delete. They won't re-download unless you restore them in sandboxtest-config.ini.

What's the difference between Std-* and custom lists?

  • Std-* = Downloaded from GitHub, can be customized with CUSTOM OVERRIDE
  • Custom = Your own lists, never synced from GitHub

Script Mapping

How does script auto-selection work?

When you select a folder, SandboxStart scans for files matching patterns in wsb\script-mappings.txt and loads the appropriate script.

Can I create custom scripts?

Yes:

  1. Create .ps1 file in wsb\ folder
  2. Add pattern to wsb\script-mappings.txt
  3. Use $SandboxFolderName variable in your script

What is $SandboxFolderName?

A placeholder variable replaced with the actual folder name at runtime. Always use this instead of hardcoding folder names.

Technical

Why UTF-8 encoding?

To support international characters (Swedish, Chinese, etc.). Old versions used ASCII which broke non-English folder names.

Why CRLF line endings?

Windows Sandbox and PowerShell expect Windows-style line endings. Unix (LF) line endings can cause issues.

Can I run this from command line?

The GUI doesn't support command-line parameters. It's designed for interactive use.

Where are settings saved?

  • Start Menu shortcut tracks script location
  • Package list config: wsb\sandboxtest-config.ini
  • UI theme preference: HKEY_CURRENT_USER\Software\SandboxStart
  • No other settings are persistent

Can I customize file extension mappings?

Yes, edit wsb\sandboxtest-config.ini under the [Extensions] section:

[Extensions]
py=Std-Python
ahk=Std-AHK
au3=Std-AU3
lua=Std-Lua     # Add custom mappings
tcl=MyTclTools  # Custom extensions appear in file dialog

Benefits:

  • When you select a file with a matching extension, the corresponding package list auto-selects
  • Custom extensions automatically appear in the file dialog filter (before ahk, au3, py, js)

How do I uninstall?

  1. Delete the SandboxStart folder
  2. Delete Start Menu shortcut: %AppData%\Microsoft\Windows\Start Menu\Programs\SandboxStart.lnk
  3. Optional: Delete cache: %LOCALAPPDATA%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\SandboxTest\

Still Have Questions?