Skip to content

Commit

Permalink
Update Win-FOR to work properly on various language sets
Browse files Browse the repository at this point in the history
  • Loading branch information
digitalsleuth committed Jul 9, 2023
1 parent bee5370 commit 1183bb5
Show file tree
Hide file tree
Showing 12 changed files with 962 additions and 1,050 deletions.
51 changes: 6 additions & 45 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,18 @@
# Win-FOR

Windows Forensics Environment (Win-FOR) Builder
Windows Forensics (Win-FOR) Customizer

The design behind this is to use a barebones Windows 10 VM or a Windows machine (preferably 1909 and higher to support WSLv2).
Once configured, and activated (to support customization features), then you can use one of the installers to
install all of the packages.
install all of the packages.

The installation methods are:

- Win-FOR Customizer: graphical interface to click and choose which items you want, and to enter the settings you need
- winfor-cli.exe: a command-line tool, requiring execution from an Administrator command prompt **SOON TO BE DEPRECATED**
- winfor-cli.ps1: a PowerShell based tool, exactly the same as the command-line exe, but requires an Administrator PowerShell prompt and to have the `Set-ExecutionPolicy Bypass` parameter set **SOON TO BE DEPRECATED**
The installer is a graphical interface to click and choose which items you want, and to enter the settings you need

Check out the [Releases](https://github.com/digitalsleuth/WIN-FOR/releases) section for the most up-to-date installers.

## Win-FOR Customizer

**FIRST OFF - Requires .NET 6.0 Desktop Runtime**
**FIRST OFF - Requires .NET 6.0 Desktop Runtime**
**If you do not have it, you will be prompted to install at execution**

Why a GUI? Who doesn't like a good GUI!?
Expand All @@ -32,51 +28,16 @@ The customizer tool gives you the following features:
- Check for updates to the Customizer
- Graphically enter any settings you need!

**The `Install` and `WSL Only` features are only accessible if the Customizer is run as Administrator (since these need Admin privileges to execute)**

![screenshot-v6 0 0](https://github.com/digitalsleuth/WIN-FOR/raw/main/images/screenshot-v6.0.0.png)

![screenshot-options-v6 0 0](https://github.com/digitalsleuth/WIN-FOR/raw/main/images/screenshot-options-v6.0.0.png)


## PowerShell or CLI

If using the PowerShell script, the install requires that the `Set-ExecutionPolicy Bypass` feature be set to allow the script to run at least twice, depending on your choices.
This is best left to you to decide what is acceptable in your organization.

If using the standalone executable script, you can execute this from an Administrator Command Prompt.

### Usage of the CLI or PowerShell script

```text
Usage (.\winfor-cli.ps1 or winfor-cli.exe):
winfor-cli -Install -User <user> -Mode <mode> -IncludeWsl -XUser forensics -XPass "<your_password>"
winfor-cli -Install -StandalonesPath "C:\standalones"
winfor-cli -Update
winfor-cli -Upgrade
winfor-cli -WslOnly
winfor-cli -Version
winfor-cli -Help
Usage:
-Install Installs the Win-FOR environment
-User <user> Choose the desired username for which to configure the installation
-Mode <mode> There are two modes to choose from for the installation:
addon: Install all of the tools, but don't do any customization
dedicated: Assumes you want the full meal-deal, will install all packages and customization
-StandalonesPath Choose the path for where the standalone executables will be downloaded
-Update Identifies the current version of Win-FOR and re-installs all states from that version
-Upgrade Identifies the latest version of Win-FOR and will install that version
-Version Displays the current version of Win-FOR (if installed) then exits
-XUser The Username for the X-Ways portal - Required to download and install X-Ways
-XPass The Password for the X-Ways portal - Required to download and install X-Ways - USE QUOTES
-IncludeWsl Will install the Windows Subsystem for Linux v2 with SIFT and REMnux toolsets
This option assumes you also want the full Win-FOR suite, install that first, then WSL
-WslOnly If you wish to only install WSLv2 with SIFT and REMnux separately, without the tools
```
The PowerShell script and standalone CLI executable have been deprecated in favour of the Win-FOR Customizer.
However, if there is need for a command-line version of the Customizer, it can be done. Until such time, the Customizer is your best choice!

## Issues

All issues should be raised [here](https://github.com/digitalsleuth/WIN-FOR/Issues)

The standalone executable installer converted from PowerShell to executable using [PS2EXE](https://github.com/MScholtes/PS2EXE)
Binary file modified WIN-FOR-Tool-List.pdf
Binary file not shown.
2 changes: 1 addition & 1 deletion WinFOR-Customizer/App.xaml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
<Application x:Class="WinFOR_Customizer.App"
<Application x:Class="WinFORCustomizer.App"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
StartupUri="MainWindow.xaml">
Expand Down
2 changes: 1 addition & 1 deletion WinFOR-Customizer/ErrorWindow.xaml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
<Window x:Class="WinFOR_Customizer.ErrorWindow"
<Window x:Class="WinFORCustomizer.ErrorWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
Expand Down
2 changes: 1 addition & 1 deletion WinFOR-Customizer/ErrorWindow.xaml.cs
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
using System.Windows;
using System.Text;

namespace WinFOR_Customizer
namespace WinFORCustomizer
{
/// <summary>
/// Interaction logic for ErrorWindow.xaml
Expand Down
Loading

0 comments on commit 1183bb5

Please sign in to comment.