|
4 | 4 |
|
5 | 5 | [](https://github.com/FaserF/SwitchCraft/releases) |
6 | 6 |
|
7 | | -**SwitchCraft** is your ultimate utility for identifying silent installation parameters for EXE and MSI packages. Designed for IT Admins, Packagers, and Developers. |
| 7 | +**SwitchCraft is your comprehensive packaging assistant for IT Professionals. It goes beyond simple switch identification to streamline your entire application packaging workflow: |
| 8 | + |
| 9 | +- 🔍 **Universal Analysis**: Instantly identify silent switches for EXE, MSI, and obscure installer frameworks. |
| 10 | +- 🤖 **AI-Powered Helper**: Get context-aware packaging advice and troubleshooting for Intune errors. |
| 11 | +- 📦 **Intune Ready**: Generate standardized PowerShell installation scripts automatically. |
| 12 | +- 🌍 **Cross-Platform**: Download and manage installers for Windows, Linux, and macOS. |
| 13 | +- 🛡️ **Integrity & Security**: Brute-force analysis for undocumented installers and file integrity checks. |
| 14 | + |
8 | 15 |
|
9 | 16 | <div align="center"> |
10 | 17 | <img src="images/switchcraft_ui.png" alt="SwitchCraft UI" width="500" /> |
@@ -84,7 +91,15 @@ SwitchCraft-Setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART |
84 | 91 | SwitchCraft-Setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /DEBUGMODE |
85 | 92 | ``` |
86 | 93 |
|
87 | | -**Silent Uninstall:** Use the same switches with the uninstaller from Add/Remove Programs. |
| 94 | + |
| 95 | +**Silent Uninstall:** |
| 96 | +```powershell |
| 97 | +# Standard Silent Uninstall |
| 98 | +"%LOCALAPPDATA%\FaserF\SwitchCraft\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART |
| 99 | +
|
| 100 | +# Via SwitchCraft.ps1 Helper Script |
| 101 | +.\SwitchCraft.ps1 -InstallMode Uninstall |
| 102 | +``` |
88 | 103 |
|
89 | 104 | #### Debug Logging Mode |
90 | 105 | Enable verbose structured logging for troubleshooting or log analysis: |
@@ -113,18 +128,45 @@ Debug output format: |
113 | 128 | winget install FaserF.SwitchCraft |
114 | 129 | ``` |
115 | 130 |
|
| 131 | +#### CLI "One-Liner" (PowerShell) |
| 132 | +Install the latest version directly from your terminal: |
| 133 | +```powershell |
| 134 | +iex (irm https://raw.githubusercontent.com/FaserF/SwitchCraft/main/install.ps1) |
| 135 | +``` |
| 136 | + |
| 137 | +**Installer Script Parameters:** |
| 138 | +The install script supports several optional parameters: |
| 139 | +```powershell |
| 140 | +# Install specific version (e.g. v2025.12.1) |
| 141 | +.\install.ps1 -Version "v2025.12.1" |
| 142 | +
|
| 143 | +# Download Portable Version to Desktop instead of installing |
| 144 | +.\install.ps1 -Portable |
| 145 | +
|
| 146 | +# Silent Mode (for automated deployments) |
| 147 | +.\install.ps1 -Silent |
| 148 | +``` |
| 149 | + |
116 | 150 | ### Enterprise Deployment |
117 | 151 |
|
118 | | -SwitchCraft is enterprise-ready and supports management via: |
119 | | -- **Group Policy (GPO)**: Using ADMX templates |
120 | | -- **Microsoft Intune**: Using ADMX ingestion or custom OMA-URIs |
121 | | -- **Registry**: Comprehensive configuration control |
| 152 | +SwitchCraft is completely ready for modern management: |
| 153 | +- **Intune Script Generation**: Automatically create `.intunewin` ready install/uninstall scripts (PowerShell) directly from the analysis result. |
| 154 | +- **MacOS Support**: Generate `install.sh` scripts and `.mobileconfig` profiles for Intune management of Mac apps. |
| 155 | +- **Custom Templates**: Use your own company-branded PowerShell templates for script generation (configure in Settings). |
122 | 156 |
|
123 | 157 | | Documentation | Description | |
124 | 158 | |---------------|-------------| |
125 | 159 | | [Registry Reference](docs/Registry.md) | All registry values and settings | |
126 | 160 | | [GPO / Intune Policies](docs/PolicyDefinitions/README.md) | OMA-URI configuration and ADMX templates | |
127 | 161 |
|
| 162 | +## 🍎 MacOS Support |
| 163 | +SwitchCraft runs on MacOS (build from source or use binary releases) and supports analysis of: |
| 164 | +- **.dmg** (Disk Images) - Detects mountable apps |
| 165 | +- **.pkg** (Installer Packages) - Extracts Package IDs and Version |
| 166 | +- **.app** (Bundles) - Reads Info.plist metadata |
| 167 | + |
| 168 | +> **Note**: While the app runs on MacOS, "Silent Switch" detection is primarily a Windows concept. On MacOS, it helps generate deployment scripts. |
| 169 | +
|
128 | 170 | > [!WARNING] |
129 | 171 | > ### ⚠️ False Positive Virus Warnings |
130 | 172 | > |
@@ -183,10 +225,8 @@ Third-party AV software may flag SwitchCraft because: |
183 | 225 |
|
184 | 226 | 1. **Check the source**: Download only from [GitHub Releases](https://github.com/FaserF/SwitchCraft/releases) |
185 | 227 | 2. **Verify the hash**: Compare SHA256 hash with the one published on the release page |
186 | | -3. **Scan on VirusTotal**: Upload to [virustotal.com](https://www.virustotal.com) – expect 2-5 detections on new releases (these decrease over time) |
187 | | -4. **Build from source**: Clone this repo and build yourself with `pyinstaller switchcraft.spec` |
188 | | - |
189 | | -No Python installation required! |
| 228 | +3. **Scan on VirusTotal**: Upload to [virustotal.com](https://www.virustotal.com) – expect 2-5 detections on new releases (these decrease over time). If you see 30+ detections, it might be a real issue or modified file. |
| 229 | +4. **Build from source**: Clone this repo and build yourself with `pyinstaller switchcraft.spec`. No Python coding knowledge required! |
190 | 230 |
|
191 | 231 | ### From Source |
192 | 232 | ```bash |
|
0 commit comments