SwitchCraft is your comprehensive packaging assistant for IT Professionals. It goes beyond simple switch identification to streamline your entire application packaging workflow.

• ✨ Features & Analysis: Detailed breakdown of supported installers and analysis capabilities.
• 🤖 CLI Reference: Command-line usage, JSON output, and headless operation.
• 🏗️ CI Architecture: Build process, pip structure, and testing guide.
• 📦 Winget Store & Integration: Using the Winget Store and Auto-Update deployment.
• ☁️ Enterprise & Intune: Guide to Automation, Intune Uploads, Group Assignments, and Script Signing.
• Registry Reference: Configuration via Registry.
• GPO / Policies: ADMX Templates.
• 🔐 Security Guide: Details on Encryption, ASR, and Safe Usage.

SwitchCraft uses a modular addon system for advanced features like Intune Integration and AI Analysis. This ensures the core tool remains lightweight and less prone to false-positive antivirus detections.

• Manual Install: You can upload custom addons in Settings.
• 👉 Read the Addon Guide for more details.

SwitchCraft is available in two distinct design versions. You can install both side-by-side or choose the one that fits your workflow.

When you visit the Releases Page, you will see several files. Here is what they do:

1. Application Executables:

   • SwitchCraft-Setup.exe: (Recommended) The classic installer. Handles shortcuts, uninstallation, and file associations.
   • SwitchCraft-windows.exe: A portable version of the Classic app. No installation required.
   • SwitchCraft_Modern-windows.exe: A portable version of the Modern (Flet) app.

2. Addon Packages (Optional, for offline/manual install):

   • switchcraft_advanced.zip: Intune & Brute-force modules.
   • switchcraft_winget.zip: Winget Store integration.
   • switchcraft_ai.zip: AI Chat assistant components.
   • Note: These are usually downloaded automatically by the app, but provided here for offline environments.

3. Metadata:

   • manifest.json / update.json: Used by the app's auto-update system.
   • Source code: The raw source for developers.

Download from the Releases page:

• SwitchCraft-Setup.exe – Full installer with Start Menu, Desktop shortcuts.
  • User Scope: Installs to %LOCALAPPDATA% (Default).
  • Machine Scope: Run as Admin to install to %PROGRAMFILES%.
  • Silent Install: SwitchCraft-Setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

• Windows: SwitchCraft-windows.exe (No Install required)

winget install FaserF.SwitchCraft

iex (irm https://raw.githubusercontent.com/FaserF/SwitchCraft/main/install.ps1)

Simply run the application without arguments:

switchcraft

Then Drag & Drop your installer into the window or click to browse.

• --json: Output analysis results in JSON format.
• --install-addons=<list>: Install specific addons (e.g., ai,winget or all).
• --debug: Enable the debug console on startup (if addon is installed).

SwitchCraft now supports a modular addon system to keep the core application lightweight and minimize antivirus false positives.

• Advanced Analysis & Intune: Deep inspection of wrappers and direct Intune publication.
• Winget Store Integration: Search and deploy from the official Microsoft repository.
• AI Helper: Dynamic chat assistant for packaging guidance (Requires Gemini/OpenAI API Key).
• Debug Console: Real-time logging console for troubleshooting.

Manage addons via Settings > Addon Manager or CLI:

# Install all recommended addons
switchcraft --install-addons=advanced,winget

• Batch Processing: Drag & Drop multiple files to analyze them sequentially.
• Analysis History: Keep track of your last 100 analyzed installers.
• Winget Toggle: Easily enable/disable store integration to suit your workflow.
• Enhanced AI: Support for local AI, Gemini (Free tier), and OpenAI.
• Cloud Sync: Sync your configuration and settings across devices using GitHub Gists.
• Script Signing: Automatically sign generated PowerShell scripts with your Code Signing Certificate.

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.ps1

The executable will be placed in your Downloads folder.

Run the shell script:

./scripts/build_release.sh

The binary will be placed in your Downloads folder.

Open Source under the MIT License. PRs are welcome!

1. Fork the repository
2. Create your feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

MIT © 2025 FaserF

• GitHub Repository
• Release Downloads
• Silent Install Database