Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/slluxx/sandboxer
A tool to speed up Windows Sandbox (or any other PC) setup.
https://github.com/slluxx/sandboxer
configuration dotnet mica sandbox setup windows windows-sandbox winui3 wpf
Last synced: 4 months ago
JSON representation
A tool to speed up Windows Sandbox (or any other PC) setup.
- Host: GitHub
- URL: https://github.com/slluxx/sandboxer
- Owner: Slluxx
- License: gpl-3.0
- Created: 2024-06-21T22:39:56.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-06-23T20:28:05.000Z (7 months ago)
- Last Synced: 2024-10-10T14:05:02.852Z (4 months ago)
- Topics: configuration, dotnet, mica, sandbox, setup, windows, windows-sandbox, winui3, wpf
- Language: C#
- Homepage:
- Size: 2.03 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Sandboxer
Sandboxer is a C# tool designed to streamline Windows Sandbox configuration, offering a user-friendly GUI and several built-in PowerShell scripts. You can enhance its functionality by adding your own scripts.
**Note:** Despite being named "Sandboxer" and initially intended for Windows Sandbox, it can be effectively employed in any (windows-)environment of your choosing.
## Why Sandboxer?
Windows Sandbox limits users to a single Logon command, which can be restrictive. While batch or PowerShell scripts provide flexibility, managing multiple tasks that you only sometimes want can become cumbersome. Sandboxer simplifies this process by allowing scripts to execute seamlessly with "ExecutionPolicy Bypass", making it easier to manage and execute your tasks.
## Extending Functionality with Custom Scripts
Extend Sandboxer's capabilities by adding your own scripts. Scripts can introduce custom UI elements (currently checkboxes) defined in a specific format using XML-like syntax:
```xml
#! SANDBOXER:
#! SANDBOXER: Chrome
#! SANDBOXER: Firefox
#! SANDBOXER: Edge
#! SANDBOXER:
```
(For detailed usage, refer to the [Install Browser](https://github.com/Slluxx/Sandboxer/blob/main/src/Resources/Install%20Browser.ps1) PowerShell script.)
## Version Options
Choose from two versions based on your system's requirements:
- **Lightweight Executable**: Utilizes the existing .NET runtime (requires .NET 8), offering a compact 5MB version with faster startup times.
- **Self-contained Executable**: Includes all necessary runtime components, ensuring compatibility on systems without .NET 8 installed, albeit with a larger file size.
## Getting Started with Sandboxer
To use Sandboxer in Windows Sandbox:
1. Mount a folder containing Sandboxer.
2. Execute Sandboxer using the logon command.
For example, mount the host desktop into the sandbox and run Sandboxer from there. Alternatively, set `ReadOnly` to `true` to prevent downloaded files from interacting with the host PC.
```xml
C:\Users\Username\Desktop
C:\Users\WDAGUtilityAccount\Desktop\Host
false
C:\Users\WDAGUtilityAccount\Desktop\Host\sandboxer\sandboxer.exe
```
## Building Sandboxer
To build Sandboxer:
1. Clone the repository.
2. Navigate to the `.\src` directory.
3. Run `dotnet build` for a standard build or `dotnet build -c NNL` for the lightweight version. Alternatively, use `dotnet publish` to create deployable packages.
Adjustments to the `csproj` file may be necessary; contributions via pull requests are welcome.
## Licenses
This project is licensed under the GNU General Public License v3.0. Additional components, such as the WPF UI library, are licensed under the MIT License. For detailed licensing information, refer to the LICENSE and LICENSE-MIT files.