SwitchCraft is your comprehensive packaging assistant for IT Professionals. It goes beyond simple switch identification to streamline your entire application packaging workflow.
SwitchCraft is primarily designed for Windows environments. While the application UI is built with cross-platform frameworks (Python/Flet), many core features rely on Windows-specific APIs (Registry, Explorer, Intune Packaging Tool).
| Feature | Windows | macOS / Linux | Reason / Limitation |
|---|---|---|---|
| Modern UI | ✅ | ✅ | Runs natively via Flet (Flutter). |
| Intune Packaging | ✅ | ❌ | Requires IntuneWinAppUtil.exe (Windows binary). |
| Configuration | ✅ | Full support via Registry (GPO/Intune). No local config file support yet. | |
| Winget Store | ✅ | ❌ | Requires winget CLI (Windows native). |
| System Integration | ✅ | Explorer integration, Notifications, and PowerShell features are Windows-only. | |
| Analyze Installer | ✅ | ✅ | Basic file analysis works, but advanced PE analysis is Windows-native. |
Warning
macOS and Linux users: You can run the application to view the interface or analyze simple files, but you cannot create Intune packages or use Store features. These builds are essentially "Viewers" and are not actively supported.
- Smart Installer Analysis: Deep inspection of MSI, EXE (Inno Setup, NSIS, InstallShield), and custom wrappers.
- Intune Integration: Automated creation of
.intunewinpackages and direct publication to Microsoft Intune. - Advanced Wrapper Support: Identification of nested installers and extraction of silent switches.
- Batch Processing: Drag & Drop multiple files to analyze them sequentially.
- Analysis History: Keep track of your last 100 analyzed installers.
- Community Database: Integrated lookup for known silent switches when local analysis fails.
- Project Stacks: Group applications into named stacks for one-click batch deployment.
- Interactive Dashboard: Visual overview of your packaging activity, statistics, and recent actions.
- Script Signing: Automatically sign generated PowerShell scripts with your Code Signing Certificate.
- Packaging Wizard: End-to-End workflow from installer to Intune upload in 5 steps.
- Live Detection Tester: Verify intended Registry, File, or MSI detection rules locally before uploading.
- Winget Store Integration: Search, analyze, and deploy applications from the official Microsoft repository.
- Auto-Update Support: Built-in logic to handle application updates in enterprise environments.
- Portable & Setup Variants: Choose between full installation or zero-residue portable executables.
- Winget Toggle: Easily enable/disable store integration to suit your workflow.
- Enterprise Configuration: Full support for Registry-based configuration via GPO or Intune OMA-URI.
- CLI Mode: Headless operation for CI/CD pipelines and automation scripts with JSON output.
- Cloud Sync: Sync your configuration and settings across devices using GitHub Gists.
- Modular Addon System: Extend functionality with optional components like AI analysis or Intune integration.
- Enhanced AI Helper: Dynamic chat assistant for packaging guidance supporting Local AI, Gemini, and OpenAI.
SwitchCraft maintains a crowdsourced database of silent switches to help everyone package apps faster.
How to contribute:
- Go to the Issues tab.
- Click New Issue.
- Select "Suggest a New Switch".
- Fill out the form with the App Name, Version, and Silent Switch.
Once submitted, our automated system will validate the switch and create a Pull Request to merge it into the main database! 🚀
SwitchCraft provides multiple editions to suit different environments.
| Edition | UI Technology | Status | Best For |
|---|---|---|---|
| Modern | Flet (Flutter) | ✅ Active | Most Users - Latest features, modern UI. |
| Legacy | Tkinter | Old Hardware - Lightweight, classic stability. | |
| CLI | Terminal | ✅ Active | Automation - Headless, scriptable, JSON output. |
| Filename | Type | Description | Pros / Cons |
|---|---|---|---|
SwitchCraft-Setup.exe |
Installer | Installs Modern edition. | ✅ Auto-Updates, Shortcuts / ❌ Requires Install |
SwitchCraft-windows.exe |
Portable | Standalone Modern edition. | ✅ No Install, Portable / ❌ No Auto-Update |
SwitchCraft-Legacy-Setup.exe |
Installer | Installs Legacy edition. | ✅ Classic Stability / ❌ Old UI |
SwitchCraft-Legacy.exe |
Portable | Standalone Legacy edition. | ✅ Ultra-lightweight / ❌ Old UI |
SwitchCraft-CLI-windows.exe |
CLI | Command-line tool. | ✅ Fast, Scriptable / ❌ No GUI |
SwitchCraft-linux |
Binary | Portable for Linux. | |
SwitchCraft-macos |
Binary | Portable for macOS. |
Note
Intune & Winget Support requires Windows. The Linux and macOS builds are primarily for viewing or platform-agnostic analysis.
If SwitchCraft encounters a startup error, it automatically saves a crash dump with detailed information.
| Platform | Location |
|---|---|
| Windows | %APPDATA%\FaserF\SwitchCraft\Logs\crash_dump_<timestamp>.txt |
| Linux/macOS | ~/.switchcraft/Logs/crash_dump_<timestamp>.txt |
When reporting issues, please attach the crash dump file to help with debugging.
SwitchCraft stores data in the following locations. This is useful for backup, cleanup, or troubleshooting.
| Type | Location | Description |
|---|---|---|
| User Preferences | HKCU\Software\FaserF\SwitchCraft |
Theme, language, settings (Registry) |
| Machine Preferences | HKLM\Software\FaserF\SwitchCraft |
Admin-configured defaults (Registry) |
| GPO/Intune Policies | HKCU\Software\Policies\FaserF\SwitchCraft |
Enforced user policies (Registry) |
| Machine Policies | HKLM\Software\Policies\FaserF\SwitchCraft |
Enforced machine policies (Registry) |
| Analysis History | %APPDATA%\FaserF\SwitchCraft\history.json |
Last 100 analyzed files |
| Crash Dumps | %APPDATA%\FaserF\SwitchCraft\Logs\*.txt |
Error diagnostics |
| Addons | %USERPROFILE%\.switchcraft\addons\ |
Installed addon extensions |
| Secrets (API Keys) | Windows Credential Manager | Stored under "SwitchCraft" (secure keyring) |
| IntuneWinAppUtil | App working directory or configured path | Downloaded on first Intune package creation |
| Type | Location | Description |
|---|---|---|
| Addons | ~/.switchcraft/addons/ |
Installed addon extensions |
| Logs | ~/.switchcraft/Logs/ |
Crash dumps and diagnostics |
| Secrets | System Keyring (libsecret/Keychain) | API keys stored securely |
To completely remove all SwitchCraft data, use Settings → Factory Reset which:
- Deletes the Registry key at
HKCU\Software\FaserF\SwitchCraft. - Removes all secrets from the system keyring.
- Deletes the data folder at
%APPDATA%\FaserF\SwitchCraft(Logs, History, Cache). - Deletes the addons folder at
%USERPROFILE%\.switchcraft.
When reporting issues, please attach the crash dump file to help with debugging.
SwitchCraft includes helper scripts to easily build release executables for your platform.
Run the PowerShell script to install dependencies and build the EXE:
.\scripts\build_release.ps1The executable will be placed in your Downloads folder.
Run the shell script:
./scripts/build_release.shThe binary will be placed in your Downloads folder.
Open Source under the MIT License. PRs are welcome!
- Fork the repository
- Create your feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
MIT © 2025 FaserF
![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4){kind=small}
![@renovate[bot]](https://avatars.githubusercontent.com/in/2740?s=64&v=4){kind=small}