1. Download VStitcher-CLI
The official download page for Browzwear products:
From this page, download newest version of VS Engine (VS-CLI)
2. System Requirements
Windows
Windows 10 / 11
Windows Server 2019 / 2022
CPU with AVX2 support
Visual C++ 2015–2022 Runtime (installed automatically by CLI installer)
macOS
macOS 12+ (Monterey / Ventura / Sonoma)
Apple Silicon M1/M2/M3 or Intel
License Requirement
Authentication via StylezoneConnect is required.
3. Install VStitcher-CLI
Windows Installation
Run the downloaded installer:
VStitcher-CLI_<version>.exe
It installs into:
C:\Program Files\Browzwear\VStitcher-CLI\<version>\
StylezoneConnect.exe is automatically installed inside this folder.
macOS Installation
Drag the CLI .app into Applications:
/Applications/VStitcher-CLI <version>.app
StylezoneConnect.app is included inside the bundle.
4. Log in to License (Required Before Running CLI Scripts)
Run StylezoneConnect (installed together with the CLI).
Windows Login Command
$stylezone = "$env:ProgramFiles\Browzwear\VStitcher-CLI\2025.2\StylezoneConnect.exe" & $stylezone --login --username="YOUR_EMAIL" --password="YOUR_PASSWORD"
If nothing prints, that's normal — check $LASTEXITCODE.
macOS Login Command
"/Applications/StylezoneConnect.app/Contents/MacOS/StylezoneConnect" \ --login --username="YOUR_EMAIL" --password="YOUR_PASSWORD"
Verify Login
Look for logs in:
Windows:
%LOCALAPPDATA%\Browzwear\log\
macOS:
~/Library/Application Support/Browzwear/log/
You should see:
StylezoneConnect-*.log
5. Basic VStitcher-CLI Test
Windows
& "C:\Program Files\Browzwear\VStitcher-CLI\2025.2\VStitcher-CLI.exe" --version
macOS
"/Applications/VStitcher-CLI 2025.2.app/Contents/MacOS/VStitcher-CLI" --version
Expected output:
VStitcher-CLI 15.2.1 Build:54551
6. Running a Sample CLI Python Script
Make a folder containing:
cli_test.py WelcometoBW_Outfit.bw
Example Windows path:
C:\CLI-TEST\
Sample Script: cli_test.py
import BwApi
bwfile = r"C:\CLI-TEST\WelcometoBW_Outfit.bw"
output = r"C:\CLI-TEST\output"
preset = '{"exportType":"image","fileFormat":"png","width":3000,"height":3000,"alphaMode":"BLEND"}'
BwApi.GarmentOpen(bwfile)
gid = BwApi.GarmentId()
snaps = BwApi.GarmentSnapshotIdsEx(gid)
BwApi.SnapshotLoadEx(gid, '{"load_snapshot_option":"saved_colorway_and_avatar","sync_snapshot":true}', snaps[0])
BwApi.RenderExportByPreset(gid, preset, output)
7. Run Script With VStitcher-CLI
Windows
& "C:\Program Files\Browzwear\VStitcher-CLI\2025.2\VStitcher-CLI.exe" ` --script "C:\CLI-TEST\cli_test.py"
macOS
"/Applications/VStitcher-CLI 2025.2.app/Contents/MacOS/VStitcher-CLI" \ --script "/Users/<you>/CLI-TEST/cli_test.py"
8. Check Output
Rendered files appear under:
C:\CLI-TEST\output\
or:
~/CLI-TEST/output/
9. Logs & Troubleshooting
Where Logs Are Stored
Windows:
%LOCALAPPDATA%\Browzwear\log\VStitcher-CLI-<build>\
macOS:
~/Library/Application Support/Browzwear/log/VStitcher-CLI-<build>/
Common Errors & Fixes
Error | Cause | Fix |
CLI returns exit code | Missing VC++ Runtime | Reinstall VStitcher-CLI (runtime included) |
License not recognized | StylezoneConnect not logged in | Rerun login command |
Script runs but output folder empty | Missing snapshots or invalid bw file | Check garment & script logic |
Nothing prints when running login | Normal behavior | Check logs for confirmation |
10. Quick Checklist
Download VStitcher-CLI
Install CLI (includes StylezoneConnect)
Login with StylezoneConnect
Test with
--versionRun sample script
Output renders